Create video task

Changed on

Create an asynchronous text-to-video or image-to-video task. Use JSON when there are no reference images and multipart/form-data when reference images are present.

post/videos

Request

  • Base URL
    https://api.llm7.io/v1
  • URL
    https://api.llm7.io/v1/videos
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring

Client-generated idempotency key for safe retries of the same logical video task creation request.

Request body

OR

Example request

{
  "model": "seedance-2.0-mini",
  "request_type": "text-to-video",
  "prompt": "Waves crashing on rocks, cinematic slow motion",
  "duration": 8,
  "resolution": "720p",
  "size": "1280x720",
  "client_request_id": "video-demo-001"
}

Response

Queued video task

idstring required

Video task ID.

status'queued' | 'in_progress' | 'completed' | 'failed' | 'timeout' required

Video task status.

outputsstring[]

Completed output URLs. Empty or omitted until the task is completed.

Example response

{
  "id": "video_task_id",
  "status": "queued",
  "outputs": [
    "https://storage.example/output/video_task_id.mp4"
  ],
  "error": {
    "message": "Upstream generation failed."
  }
}

Changes

    • breaking

      added the new required request property (media type: application/json)

    • breaking

      added the new required request property (media type: multipart/form-data)

    • breaking

      the request property became required (media type: multipart/form-data)

    • breaking

      the request property type changed from string to number string (media type: application/json)

    • breaking

      the request property type changed from string to number string (media type: multipart/form-data)

    • warning

      added the new timeout enum value to the response property for the response status

    • info

      added the new optional header request parameter Idempotency-Key

    • info

      added the new optional request property (media type: application/json)

    • info

      added the new optional request property (media type: multipart/form-data)

    • info

      added the new optional request property (media type: application/json)

    • info

      added the new optional request property (media type: multipart/form-data)

    • info

      added the new optional request property (media type: application/json)

    • info

      added the new optional request property (media type: multipart/form-data)

    • info

      added subschema #1 subschema #2 to the request body anyOf list (media type: application/json)

    • info

      added subschema #1 subschema #2 to the request body anyOf list (media type: multipart/form-data)

    • info

      the request property became optional (media type: application/json)

    • info

      the request property became optional (media type: multipart/form-data)

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status