v1

latestOpenAPI 3.0.02026-07-26119.0 KB

Generate video using Wan 2.7 reference-to-video

post/api/v1/client/job/CreateTask

Request body

model'wan/2-7-r2v' required

The model name to use for generation. Required field.

Must be wan/2-7-r2v for this endpoint

callback_urlstring uri

Optional. Callback URL for receiving task completion notifications.

System will POST task status and results to this URL when generation completes
Callback payloads structure is consistent with the data object returned by the task status query
Your callback endpoint should accept POST requests with JSON payload containing results
It returns an HTTP 200 status code upon successful receipt

Example request

{
  "callback_url": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "A cinematic slow-motion scene of a rain-soaked city street at night, neon reflections on the wet pavement.",
    "negative_prompt": "No people, no text, no logos.",
    "reference_medias": [
      {
        "reference_image": "https://example.com/reference-character.png",
        "reference_voice": "https://example.com/reference-voice.mp3"
      },
      {
        "reference_video": "https://example.com/reference-motion.mp4"
      }
    ],
    "duration": 10,
    "resolution": "1080P",
    "aspect_ratio": "16:9",
    "region": "global",
    "input_compliance": "enable",
    "output_compliance": "enable"
  }
}

Response

Request successful

code200 | 401 | 402 | 404 | 422 | 429 | 455 | 500 | 501 | 505

Response status code

200: Success - Request has been processed successfully
401: Unauthorized - Authentication credentials are missing or invalid
402: Insufficient Credits - Account does not have enough credits to perform the operation
404: Not Found - The requested resource or endpoint does not exist
422: Validation Error - The request parameters failed validation checks
429: Rate Limited - Request limit has been exceeded for this resource
455: Service Unavailable - System is currently undergoing maintenance
500: Server Error - An unexpected error occurred while processing the request
501: Generation Failed - Content generation task failed
505: Feature Disabled - The requested feature is currently disabled

messagestring

Response message, error description when failed

Example response

{
  "message": "success",
  "data": {
    "task_id": "task_12345678"
  }
}

All 1 operations