Getting Started with Nohuman AI API

# Base URL

All API endpoints are relative to this base URL. All requests must be made over HTTPS.

# Authentication

Authenticate your API requests by including your API key in the Authorization header as a Bearer token. You can create and manage API keys from your dashboard.

# Endpoints

# Quick Start

Generate a video from a text prompt in a single API call. The response includes a poll_url that you can use to check generation status and retrieve the result.

1. Submit a generation request

curl -X POST https:"code-comment">//api.nohuman.studio/v1/videos/generate \
  -H "Authorization: Bearer $NOHUMAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cat walking on a beach at sunset",
    "duration": 5,
    "aspect_ratio": "16:9",
    "sound": true
  }'

2. Poll for results

Use the poll_url from the response to check generation status. Poll every 5 seconds until the status is completed.

GET /v1/videos/generations/{id}

// Response when completed:
{
  "id": "gen_a1b2c3d4e5f6",
  "model": "nohuman-x33",
  "status": "completed",
  "result": {
    "url": "https://cdn.nohuman.studio/v/gen_a1b2c3d4.mp4",
    "format": "mp4"
  }
}

# Response Format

The initial POST response returns the task ID and model:

{
  "id": "gen_a1b2c3d4e5f6",
  "model": "nohuman-x33",
  "status": "created",
  "poll_url": "/v1/videos/generations/gen_a1b2c3d4e5f6"
}

Statuses progress through: created -> processing -> completed or failed.

# What's Next