/v1/videosCreate 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 | integerLength, 1 to 20 (default 4). Models narrow it: Veo takes 4, 6 or 8.
sizeenuminput_referenceanyA reference image: a file part, or
{"image_url": "data:image/png;base64,..."}.
レスポンス
200The new job.
レスポンス
idstringobjectstringmodelstringstatusenumprogressinteger0 to 100.
created_atintegercompleted_atinteger | nullexpires_atinteger | nullWhen the stored video expires.
secondsstringsizestringerrorobject | null{code, message}when the job failed.remixed_from_video_idnull
400Invalid request. param names the field; code says why (invalid_parameter, unsupported_parameter, unsupported_capability, refusal, previous_response_not_found). Not charged.
レスポンス
errorobjecterror
messagestringWhat went wrong and how to fix it.
typestringFor example
invalid_request_error,authentication_error,permission_error,rate_limit_error,insufficient_quota,api_error.codestringThe stable error code.
paramstring | nullThe request field at fault, when there is one.
refusal_reasonenumPresent only on
code: refusal.
401The key is missing, malformed, expired or revoked.
レスポンス
errorobjecterror
messagestringWhat went wrong and how to fix it.
typestringFor example
invalid_request_error,authentication_error,permission_error,rate_limit_error,insufficient_quota,api_error.codestringThe stable error code.
paramstring | nullThe request field at fault, when there is one.
refusal_reasonenumPresent only on
code: refusal.
402The 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.
レスポンス
errorobjecterror
messagestringWhat went wrong and how to fix it.
typestringFor example
invalid_request_error,authentication_error,permission_error,rate_limit_error,insufficient_quota,api_error.codestringThe stable error code.
paramstring | nullThe request field at fault, when there is one.
refusal_reasonenumPresent only on
code: refusal.
429insufficient_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.
レスポンス
errorobjecterror
messagestringWhat went wrong and how to fix it.
typestringFor example
invalid_request_error,authentication_error,permission_error,rate_limit_error,insufficient_quota,api_error.codestringThe stable error code.
paramstring | nullThe request field at fault, when there is one.
refusal_reasonenumPresent only on
code: refusal.
リクエスト
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