POST/v1/videos

Create a video

Starts an asynchronous video job and returns it at once with status: queued. Poll GET /v1/videos/{video_id} until completed, then download /content.

Send JSON or multipart. An optional reference image is a file part or a data: URL (JPEG, PNG or WebP, up to 10 MiB); remote URLs are refused. Durations and sizes depend on the model.

認証: AuthorizationヘッダーにBearer形式のAPIキー

リクエストボディ

  • modelstring必須

    A video model slug.

  • promptstring必須
  • secondsstring | integer

    Length, 1 to 20 (default 4). Models narrow it: Veo takes 4, 6 or 8.

  • sizeenum
    "854x480""480x854""1280x720""720x1280""1920x1080""1080x1920""3840x2160""2160x3840"
    デフォルト: "720x1280"
  • input_referenceany

    A reference image: a file part, or {"image_url": "data:image/png;base64,..."}.

レスポンス

  • 200

    The new job.

    レスポンス
    • idstring
    • objectstring
    • modelstring
    • statusenum
      "queued""in_progress""completed""failed"
    • progressinteger

      0 to 100.

    • created_atinteger
    • completed_atinteger | null
    • expires_atinteger | null

      When the stored video expires.

    • secondsstring
    • sizestring
    • errorobject | null

      {code, message} when the job failed.

    • remixed_from_video_idnull
  • 400

    Invalid request. param names the field; code says why (invalid_parameter, unsupported_parameter, unsupported_capability, refusal, previous_response_not_found). Not charged.

    レスポンス
    • errorobject
      error
      • messagestring

        What went wrong and how to fix it.

      • typestring

        For example invalid_request_error, authentication_error, permission_error, rate_limit_error, insufficient_quota, api_error.

      • codestring

        The stable error code.

      • paramstring | null

        The request field at fault, when there is one.

      • refusal_reasonenum

        Present only on code: refusal.

        "cyber_policy""cbrn""content_policy""recitation""data_inspection""unspecified"
  • 401

    The key is missing, malformed, expired or revoked.

    レスポンス
    • errorobject
      error
      • messagestring

        What went wrong and how to fix it.

      • typestring

        For example invalid_request_error, authentication_error, permission_error, rate_limit_error, insufficient_quota, api_error.

      • codestring

        The stable error code.

      • paramstring | null

        The request field at fault, when there is one.

      • refusal_reasonenum

        Present only on code: refusal.

        "cyber_policy""cbrn""content_policy""recitation""data_inspection""unspecified"
  • 402

    The organization must act first: card_required, email_unverified, org_under_review, free_tier_requires_payment or promotion_ended. The message names the step; retrying does not help.

    レスポンス
    • errorobject
      error
      • messagestring

        What went wrong and how to fix it.

      • typestring

        For example invalid_request_error, authentication_error, permission_error, rate_limit_error, insufficient_quota, api_error.

      • codestring

        The stable error code.

      • paramstring | null

        The request field at fault, when there is one.

      • refusal_reasonenum

        Present only on code: refusal.

        "cyber_policy""cbrn""content_policy""recitation""data_inspection""unspecified"
  • 429

    insufficient_quota (out of credits, over a spend limit, or the model needs a purchase) and promo_credits_now (a free promotion is used up): add credits, the message names the step. rate_limit_exceeded, free_limit_reached, admission_capacity_exceeded: wait Retry-After seconds and retry.

    レスポンス
    • errorobject
      error
      • messagestring

        What went wrong and how to fix it.

      • typestring

        For example invalid_request_error, authentication_error, permission_error, rate_limit_error, insufficient_quota, api_error.

      • codestring

        The stable error code.

      • paramstring | null

        The request field at fault, when there is one.

      • refusal_reasonenum

        Present only on code: refusal.

        "cyber_policy""cbrn""content_policy""recitation""data_inspection""unspecified"

リクエスト

curl https://api.experientiallabs.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "veo-3.1-generate-preview", "prompt": "A paper boat drifting down a rainy street", "seconds": "8", "size": "1280x720"}'

レスポンス

{
  "id": "video_4e8a1c7b2f9d4053a6e1b8c3d7f2a910",
  "object": "video",
  "model": "veo-3.1-generate-preview",
  "status": "queued",
  "progress": 0,
  "created_at": 1795132800,
  "completed_at": null,
  "expires_at": null,
  "seconds": "8",
  "size": "1280x720",
  "error": null,
  "remixed_from_video_id": null
}

https://api.experientiallabs.ai/v1/videos