Tasks

Generate a video from references (w3.0-spicy)

Uncensored reference-to-video generation (W3.0 / Wan 3.0, 480p/720p/1080p, 2–30s): up to 10 reference images, 5 reference videos, or 5 reference audio clips, or one reference document (file_url) / web page (link_url). Reference videos are billed with the output ((Σ reference-video seconds + output seconds) × resolution rate); reference images, documents and pages add no billable seconds. Duration and resolution are required. Async: returns a task (202); poll GET /v1/tasks/{id}.

post/v1/w3.0-spicy/reference-to-video

Request

  • Base URL: https://api.hotapi.ai
  • URL: https://api.hotapi.ai/v1/w3.0-spicy/reference-to-video
  • Auth: HTTP bearer

Query parameters

webhookstring uri

Public HTTPS callback URL for the signed terminal task event. Private addresses and redirects are not supported. Deliveries use the organization's webhook signing secret.

Headers

idempotency-keystring

Stable key for one logical submission. Reuse it only when retrying the identical model and input.

Request body

reference_image_urlsstring[]

1–10 reference images (HTTP/HTTPS URLs or base64).

reference_audio_urlsstring[]

1–5 HTTPS reference audio clips. Audio-only input is supported.

reference_video_urlsstring[]

1–5 HTTPS reference video URLs (MP4/MOV, each 1–15s, ≤15s total, ≤100MB; clips under 1s are rejected before charging). Reference duration is billed with the output — the charge is (Σ reference-video seconds + output seconds) × resolution rate, from durations probed at submit — so an unreadable or over-limit reference is rejected before any credits are deducted.

file_urlstring uri

Reference document URL (docx/doc/xlsx/xls/pptx/ppt/pdf/txt/key/pages/numbers/md; ≤100MB, ≤50 pages). Mutually exclusive with link_url. Requires prompt expansion, which the gateway pins on for these requests.

link_urlstring uri

Public web page URL used as reference. Mutually exclusive with file_url. Requires prompt expansion, which the gateway pins on for these requests.

promptstring

Optional text prompt.

duration_secondsinteger required

2–30 seconds.

generate_audioboolean

Generate a synced audio track. Omitted = true.

prompt_extendboolean

Let the model rewrite/expand the prompt. Omitted = true.

seedinteger nullable

Random seed (0–2147483647). null or omitted = random.

Example request

{
  "reference_image_urls": [
    "https://example.com/ref1.jpg",
    "https://example.com/ref2.jpg"
  ],
  "reference_audio_urls": [
    "https://example.com/music.mp3"
  ],
  "reference_video_urls": [
    "https://example.com/clip.mp4"
  ],
  "file_url": "https://example.com/brief.pdf",
  "link_url": "https://example.com/article"
}

Response

An async task. Creation returns 202 with status=queued; poll GET /v1/tasks/{id} (or await the webhook) until a terminal status.

idstring required
object'task' required
modelstring required
task_kindstring required
inputobject required

The normalized request input the task was created with.

outputobject

Result payload, present once status=succeeded. Contains hosted asset URLs (re-hosted on our CDN).

estimated_credits_costinteger required

Credits charged up-front when the task was created (1000 credits = $1).

reference_video_secondsnumber

Input-video seconds measured and frozen at submission; reused for draft finalization billing. Zero when no reference video was supplied.

actual_credits_costinteger

Final credits charged after settlement (equals estimate today).

webhook_urlstring uri
api_key_idstring

The organization's API key that created the task; absent for dashboard/session-created tasks.

created_atinteger required

Unix seconds.

queued_atinteger

Unix seconds.

started_atinteger

Unix seconds.

completed_atinteger

Unix seconds.

expires_atinteger required

Unix seconds; result + asset retention deadline.

Example response

{
  "id": "task_8sd9f7aQ2",
  "model": "z-image-spicy",
  "task_kind": "image.generate",
  "error": {
    "type": "provider_error",
    "code": "generation_failed",
    "message": "Generation failed"
  },
  "estimated_credits_cost": 26,
  "api_key_id": "ak_8sd9f7aQ2"
}

Changes

No recorded changes to this operation across all 1 revision of this API.