Extend Videos
January 29, 2026 (November 20, 2026)
Table of contents
Extend a video with a new prompt: Omni 1.2 Flash continues the clip by 3 to 10 seconds and returns one clip that holds the whole source plus the new seconds. Extend the result again to keep going.
- Extending requires a paid Google AI plan (Plus, Pro or Ultra) with remaining credits. A free Google account gets
400: Google Flow doesn’t extend videos on the free plan. - Omni 1.2 Flash extends any video shorter than 30 seconds: one generated with any model (Veo included), uploaded, or already extended. A video of 30 seconds or more gets
400, so the longest result is just under 40 seconds. - The extension keeps the source’s aspect ratio (landscape or portrait). Its resolution is the source’s own unless you set
resolution. - It costs the same as an Omni 1.2 Flash generation of the added length, on every plan: at 720p 3 credits a second (10 s = 30), at 360p 1 credit a second (3 s = 3).
- Images, characters and voices can steer the extension, including a voice for new dialogue (see Request Body).
- Google is giving Omni 1.2 Flash to accounts over several days from November 5, 2026. On an account that doesn’t have it yet the request returns
400.
Google removed the Veo models from Flow’s Extend on November 18, 2026. A request with a Veo model (veo-3.1-fast, veo-3.1-quality, veo-3.1-lite or veo-3.1-lite-low-priority) returns 400 right away and nothing is charged. Leave model out, or set it to omni-flash-1.2.
https://api.useapi.net/v1/google-flow/videos/extend
Request Headers
Authorization: Bearer {API token}
Content-Type: application/json
API tokenis required, see Setup useapi.net for details.
Request Body
{
"mediaGenerationId": "user:12345-email:6a6f...-video:CAMaJDMx...",
"prompt": "The magician runs after the glowing card through the rain, calling out @referenceAudio_1: \"Come back here! You are the ace of hearts!\"",
"duration": 10,
"referenceAudio_1": "Charon"
}
mediaGenerationIdis required. ThemediaGenerationIdof a video: one from POST /videos (any model), from this endpoint, or uploaded via POST /assets/email. The video must be shorter than 30 seconds. The extension runs on the account that holds it.promptis required. What happens next. It can name the references inline with@referenceImage_1..3,@character_1..3and@referenceAudio_1..3, the same inline markers as POST /videos.modelis optional (default:omni-flash-1.2), the only model that extends. A Veo model (veo-3.1-fast,veo-3.1-quality,veo-3.1-lite,veo-3.1-lite-low-priority) returns400: Google no longer extends with them.durationis optional, the seconds to add: any whole number from3to10(default:8).resolutionis optional,360por720p(default: the source’s resolution). 360p costs a third of 720p.referenceImage_1toreferenceImage_3are optional, mediaGenerationId of images from POST /assets/emailon the same account.character_1tocharacter_3are optional, characters from POST /characters. Each character’s images count toward the same limit of 3 images.referenceAudio_1toreferenceAudio_3are optional, voices for new dialogue: a system voice name (one of the 30 presets listed on POST /videos) or a user voice from POST /voices.countis optional. Number of variations to generate (1-4, default: 1). Each variation is a separate video: a full clip of the source plus its own extension.returnSilentVideosis optional (default:false). When Google’s audio filter rejects the sound generated with the extension,falsefails the video withPUBLIC_ERROR_AUDIO_FILTEREDand Google charges nothing for it, andtruereturns it without sound, charged like any other video. Details in Videos that failed on their sound.asyncis optional, enables fire-and-forget mode (default:false). Whentrue, returns immediately with201 Createdand job metadata. Poll GET /jobs/jobIdfor completion status.replyUrlis optional, webhook URL for job status callbacks. Receives POST requests with job status updates (created,started,completed,failed). The JSON payload shape matches GET /jobs/jobIdresponse.replyRefis optional, custom reference string passed back in webhook callbacks.captchaToken,captchaRetry,captchaOrderare optional, mutually exclusive captcha parameters. See Captcha Parameters for details.
Responses
-
Video extended successfully. All video data is in the
media[]array. Withomni-flash-1.2each item is one clip of the source plus the extension: in this example a 10 s clip extended by 10 s, solengthis20s.{ "jobId": "j1115123456789539281v-u12345-email:john@gmail.com-bot:google-flow", "media": [ { "name": "a1d95d21-75d2-482d-a354-14ef8802ce66", "projectId": "9f63078c-...redacted...", "workflowId": "fa986834-...redacted...", "workflowStepId": "CAE", "mediaMetadata": { "createTime": "2026-11-06T02:13:29.851988Z", "mediaTitle": "The magician runs after the glowing card through the rain, calling out VoiceI: \"Come back here! You are the ace of hearts!\"", "mediaBlobSize": "10618058", "mediaStatus": { "mediaGenerationStatus": "MEDIA_GENERATION_STATUS_SUCCESSFUL" }, "visibility": "PRIVATE", "requestData": { "videoGenerationRequestData": { "backend": "flow", "statusEnum": 3, "aspectEnum": 2, "videoModelControlInput": { "videoModelName": "models/omni_1p5_pro_flow", "videoGenerationMode": "VIDEO_GENERATION_MODE_VIDEO_EXTENSION", "videoAspectRatio": "VIDEO_ASPECT_RATIO_LANDSCAPE", "videoResolution": "VIDEO_RESOLUTION_720P" } }, "promptInputs": [ { "structuredPrompt": { "parts": [ { "text": "The magician runs after the glowing card through the rain, calling out " }, { "reference": { "audio": { "mediaId": "5b0e2c1d-...redacted...", "handle": "VoiceI" } } }, { "text": ": \"Come back here! You are the ace of hearts!\"" } ] } } ], "clientPlatform": "CLIENT_PLATFORM_WEB" } }, "video": { "generatedVideo": { "seed": 267051, "prompt": "The magician runs after the glowing card through the rain, calling out audio_0.wav : \"Come back here! You are the ace of hearts!\"", "model": "macaron_cookie_extend_10s", "baseImageMediaGenerationId": "", "isLooped": false, "aspectRatio": "VIDEO_ASPECT_RATIO_LANDSCAPE" }, "dimensions": { "length": "20s" }, "operation": { "name": "a1d95d21-...redacted..." } }, "mediaGenerationId": "user:12345-email:6a6f...-video:a1d95d21-...redacted...", "videoUrl": "https://flow-content.google/video/a1d95d21-...redacted...?Expires=...", "thumbnailUrl": "https://flow-content.google/image/a1d95d21-...redacted...?Expires=..." } ], "operations": [], "remainingCredits": 847, "captcha": { "service": "AntiCaptcha", "taskId": "931846120", "durationMs": 15243, "attempts": [ { "service": "AntiCaptcha", "success": true, "durationMs": 15243, "cost": "0.00200", "ip": "203.0.113.24", "createTime": 1794787642, "endTime": 1794787657, "solveCount": 0, "taskId": "931846120", "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/153.0.0.0 Safari/537.36" } ] } } -
Job created in async mode (
async: true). Video extension is processing in the background.Use GET /jobs/
jobIdto poll for completion status.{ "jobid": "j1115123456789539281v-u12345-email:john@gmail.com-bot:google-flow", "type": "video", "status": "created", "created": "2026-11-15T12:34:56.789Z", "request": { "prompt": "The camera rises above the mountains as the sun sets behind them", "mediaGenerationId": { "user": 12345, "email": "john@gmail.com", "type": "video", "id": "a1d95d21-75d2-482d-a354-14ef8802ce66", "referenceId": "user:12345-email:6a6f...-video:a1d95d21-75d2-482d-a354-14ef8802ce66" }, "async": true, "email": "john@gmail.com" }, "response": { "operations": [], "media": [ { "name": "d83b61f0-...redacted...", "projectId": "9f63078c-...redacted...", "workflowId": "fa986834-...redacted...", "workflowStepId": "CAI", "mediaMetadata": { "createTime": "2026-11-15T12:35:01.053004Z", "mediaTitle": "The camera rises above the mountains as the sun sets behind them", "mediaStatus": { "mediaGenerationStatus": "MEDIA_GENERATION_STATUS_PENDING" }, "visibility": "PRIVATE", "requestData": { "videoGenerationRequestData": { "backend": "flow", "statusEnum": 6, "aspectEnum": 2, "videoModelControlInput": { "videoModelName": "models/omni_1p5_pro_flow", "videoGenerationMode": "VIDEO_GENERATION_MODE_VIDEO_EXTENSION", "videoAspectRatio": "VIDEO_ASPECT_RATIO_LANDSCAPE", "videoResolution": "VIDEO_RESOLUTION_720P" } }, "promptInputs": [ { "structuredPrompt": { "parts": [{ "text": "The camera rises above the mountains as the sun sets behind them" }] } } ], "clientPlatform": "CLIENT_PLATFORM_WEB" } }, "video": { "generatedVideo": { "seed": 267051, "prompt": "The camera rises above the mountains as the sun sets behind them", "model": "macaron_cookie_extend_8s", "baseImageMediaGenerationId": "", "isLooped": false, "aspectRatio": "VIDEO_ASPECT_RATIO_LANDSCAPE" }, "dimensions": { "length": "16s" }, "operation": { "name": "d83b61f0-...redacted..." } } } ], "captcha": { "service": "CapSolver", "taskId": "14af1dbb-885c-4e25-8121-7a79489dfd0e", "durationMs": 5357, "attempts": [ { "service": "CapSolver", "success": true, "durationMs": 5357, "taskId": "14af1dbb-885c-4e25-8121-7a79489dfd0e" } ] }, "captchaAttemptsCount": 1, "captchaProviders": "CapSolver", "tier": "PAYGATE_TIER_TWO", "sku": "G1_TIER2", "remainingCredits": 847 } } -
Invalid request.
{ "error": "Parameter prompt is required", "code": 400 }A Veo
model, which Google no longer extends with:{ "error": "Google Flow no longer extends videos with Veo models: Google removed Veo video extension on 2026-11-18. Extend with model 'omni-flash-1.2' (the default), available on paid Google Flow plans (Plus, Pro or Ultra).", "code": 400 } -
Invalid API token.
{ "error": "useapi.net ⁝ Unauthorized", "code": 401 } -
Your useapi.net subscription is missing or has expired, so nothing was sent to Google. Subscribe or renew it, then send the request again.
{ "error": "useapi.net ⁝ Your account has no subscription, please subscribe to our services before submitting requests", "code": 402 }When the subscription has expired:
{ "error": "useapi.net ⁝ Monthly subscription 261008 expired, please renew your subscription before submitting new requests.", "code": 402 } -
Google rejected the captcha on every try. We retry with a fresh captcha as many times as you allow (
captchaRetry, default 5, or the providers incaptchaOrder) and return this403only when all of them were rejected. The top-levelerrorstarts withcaptcha_quality:, for example"captcha_quality: PUBLIC_ERROR_UNUSUAL_ACTIVITY after 5 attempts. Google refused all 5 captcha tokens for user@example.com, so nothing was generated and no Google Flow credits were used (5 captcha solves were spent). Google is flagging this account's requests as unusual activity. If it keeps happening, use another account, or leave out email so the API picks one. See GET /accounts/captcha-stats summary.by_account". A429withPUBLIC_ERROR_UNUSUAL_ACTIVITY_TOO_MUCH_TRAFFICreads the same way.Two
403s are not a captcha problem, and we answer them after one try instead of retrying.PUBLIC_ERROR_MODEL_ACCESS_DENIEDin the response means Google refused the model on that account, so raisingcaptchaRetryor adding providers will not help. Check that the account’s plan includes the model. Since 2026-09-23 Google no longer offersveo-3.1-lite-low-priorityto invited members of an Ultra $199 family plan — only the family manager’s account keeps it.PUBLIC_ERROR_USER_MINORmeans Google treats the Google account as belonging to someone under 18, and Google Flow is not available to such accounts. Theerrorsays so in plain words. No captcha or retry changes it: use another Google account, or have this one’s age verified with Google first. Withemailomitted, the load balancer sets such an account aside for 1 hour, then tries it again.Nothing was created when this happens. Google checks the captcha before it starts generating, so no Google credits were used and you can resubmit straight away. Your captcha provider still bills each solve.
The usual cause is the Google account, not the captcha provider. Google gives each account its own trust level. On a trusted account it accepts about 9 in 10 captchas, on a distrusted one about 3 in 10, whichever provider solved them. Most customers have a few distrusted accounts among many good ones.
To see which accounts are affected, use GET /accounts/captcha-stats. Its
summary.by_accountshows, for each of your Google accounts, how many captchas were tried and what share Google accepted. GET account/stats withbot=google-flowalso shows how many requests each account finished with each response code.- If one or a few accounts are far below the others, the API already sends them less work: when you leave out
email, each captcha Google rejected on an account in the last 15 minutes lowers its chance of being picked, for generations and for image uploads. They still get some work, so an account that recovers gets its full share back. If you pin requests withemail, move them to your other accounts yourself. Replace an account that stays low for more than a day or two. - If all your accounts drop at the same time, it’s the captcha provider. Configure at least two providers with POST /accounts/captcha-providers, and the API will start with whichever one Google accepts best.
A higher
captchaRetrygets more requests through on a distrusted account, but every extra try is another paid solve. - If one or a few accounts are far below the others, the API already sends them less work: when you leave out
-
Account not found or video not found.
{ "error": "Google Flow account john@gmail.com not found", "code": 404 } -
Video extension polling timeout (after 10 minutes).
{ "error": "Polling timeout", "code": 408 } -
Google returns several
RESOURCE_EXHAUSTED429 variants. Check thereasonfield and respond accordingly:Reason Meaning Scope What to do Cooldown PUBLIC_ERROR_USER_REQUESTS_THROTTLEDGoogle is throttling the account (the token was fine). Uploads and generation are metered separately All models on the account — or uploads only, when POST /assets triggered it Run fewer parallel requests, or switch accounts. From POST /assets, retrying the same one rarely clears it ~30 min. From POST /assets, treat it as a minimum — it can persist PUBLIC_ERROR_USER_QUOTA_REACHEDAccount’s overall Flow quota cap All models on the account Add accounts, or omit emailto load-balance~30 min PUBLIC_ERROR_PER_MODEL_DAILY_QUOTA_REACHEDPer-model daily quota Only that model, on that account Switch model, or wait Next UTC midnight PUBLIC_ERROR_UNUSUAL_ACTIVITY_TOO_MUCH_TRAFFICGoogle rejected the captcha on every try (we already retried). Usually a distrusted Google account, sometimes the provider Per request Check which accounts are affected in captcha-stats. Rest or replace those accounts. Add a second provider if all accounts drop together 60s Every
429returns the cooldown two ways — an HTTPRetry-After: <seconds>header and a bodyretryAfter: <ISO timestamp>field. Honor it before retrying.When
emailis omitted, the first three reasons quarantine the account and the load balancer routes around it. If every account is quarantined for the model you get429witherror: "no_eligible_account". Routing details: GET /jobs › Load Balancing Algorithm.Captcha-quality failures prefix the top-level
errorwithcaptcha_quality:(e.g."captcha_quality: PUBLIC_ERROR_UNUSUAL_ACTIVITY_TOO_MUCH_TRAFFIC after 3 attempts") so you can detect them without parsing the nested body. -
503has two distinct causes — check the response body to tell them apart.A transient Google-side outage. Wait 5-10 seconds and retry.
{ "error": { "code": 503, "message": "Service temporarily unavailable.", "status": "UNAVAILABLE" } }A captcha-provider failure — the top-level
erroris prefixedCaptcha service failed:. The problem is your captcha provider (check its API key and balance), not Google. Don’t retry until the provider is back.{ "error": "Captcha service failed: ERROR_ZERO_BALANCE", "code": 503 } -
596 Session Error
Google rejected the account’s session, and the API is re-verifying the account on its own: retry in about a minute. If Google signed the account out, the account keeps answering
596and you get a reconnect email: add it again by following Setup Google Flow.{ "error": "Google Flow account john@gmail.com Google rejected this account session (HTTP 401). We are automatically re-verifying it — please retry in about a minute. If the account was signed out, you will receive a reconnect email.", "code": 596 }
Model
One tab per answer: the extended videos (200, sync), the job record (201, async) and a failed job.
The answer for each status, field by field, and the types it uses (FlowVideoMedia, FlowCaptcha, FlowReference)
-
Video extension completed. Returns extended video data with signed URLs.
FlowVideoMediaandFlowCaptchaare described below the tabs.{ jobId: string // the job id, for GET /jobs/{jobid} operations: [] // always empty on this endpoint: read media[] media: FlowVideoMedia[] // one item per video. With omni-flash-1.2 each is one clip of the source plus the extension remainingCredits?: number // the account's Google Flow credits left, as Google last reported them captcha: FlowCaptcha // the captcha solved for this request } -
Job created and processing in background. Structure matches GET /jobs/
jobIdresponse. References you sent come back decoded, asFlowReferenceobjects (described below the tabs).{ jobid: string // the job id, for GET /jobs/{jobid} type: 'video' // the job type status: 'created' // the job status created: string // ISO 8601 time the job was created request: { // the request as you sent it, after validation email: string // the account the job runs on, the one that owns the source video prompt: string // the extension prompt mediaGenerationId: FlowReference // the source video model?: string // "omni-flash-1.2", when you set it duration?: number // the seconds to add, 3-10, omni-flash-1.2 resolution?: string // 360p or 720p, omni-flash-1.2 referenceImage_1?: FlowReference // a reference image, omni-flash-1.2 referenceImage_2?: FlowReference // a reference image, omni-flash-1.2 referenceImage_3?: FlowReference // a reference image, omni-flash-1.2 character_1?: FlowReference // a character, omni-flash-1.2 character_2?: FlowReference // a character, omni-flash-1.2 character_3?: FlowReference // a character, omni-flash-1.2 referenceAudio_1?: string // a voice: a built-in voice name (lowercase) or your voice reference referenceAudio_2?: string // a voice: a built-in voice name (lowercase) or your voice reference referenceAudio_3?: string // a voice: a built-in voice name (lowercase) or your voice reference count?: number // how many videos you asked for returnSilentVideos?: boolean // true: a video whose sound Google's filter rejects comes back silent captchaToken?: string // the captcha token you sent captchaRetry?: number // the captcha retries you asked for captchaOrder?: string[] // the captcha providers you listed, in order async: true // answer at once, the job runs in the background replyUrl?: string // your callback URL replyRef?: string // your reference, sent back in callbacks } response: { // Google's answer so far operations: [] // always empty on this endpoint: read media[] media: FlowVideoMedia[] // one item per video, still being made (no mediaGenerationId or URLs yet) captcha: FlowCaptcha // the captcha solved for this request captchaAttemptsCount: number // how many captcha solves were tried, one per entry of captcha.attempts captchaProviders: string // the providers tried, comma-separated, in the order tried tier: string // the account's Google plan tier when the job started, as Google reports it, e.g. "PAYGATE_TIER_TWO" sku: string // the account's Google plan code when the job started, e.g. "G1_TIER2" remainingCredits?: number // the account's Google Flow credits left, as Google reported them at submit } } -
Error response structure (applies to both sync and async modes).
{ jobId?: string // the job id, when the job had been created error: string // what went wrong, e.g. "All operations failed" or "PUBLIC_ERROR_UNSAFE_GENERATION (HTTP 400)" code?: number // the HTTP status retryAfter?: string // ISO 8601 time to retry after, on a 429 (the Retry-After header carries the same in seconds) response?: { // what the job held when it failed failureReasons?: string[] // why every video failed: Google's terminal codes and classifier labels, de-duplicated. // Present only when all videos failed AND Google gave a reason. See // "Why a generation failed" on the POST /videos page operations?: [] // always empty, kept for older clients media?: FlowVideoMedia[] // every video of the job, when none was made: each carries its own reason in mediaMetadata.mediaStatus remainingCredits?: number // the account's Google Flow credits left, as Google last reported them error?: string | { // Google's error when Google refused the request, or our own text (e.g. a polling timeout) code: number // HTTP status Google answered message: string // the error message, e.g. "flow.google.com fZytfe failed" status: string // Google's status name, e.g. "RESOURCE_EXHAUSTED" details: Array<{ // Google's error details '@type': string // the type name of the detail reason: string // Google's reason code, e.g. "PUBLIC_ERROR_USER_QUOTA_REACHED" }> } captcha?: FlowCaptcha // the captcha tried or used captchaAttemptsCount?: number // how many captcha solves were tried, when the job failed before its first poll captchaProviders?: string // the providers tried, comma-separated, when the job failed before its first poll tier?: string // the account's Google plan tier, when the job failed before its first poll sku?: string // the account's Google plan code, when the job failed before its first poll } }
The types the tabs refer to:
FlowVideoMedia: each item of media in the tabs above.
{
name: string // Google's media id of the video
projectId: string // the Google Flow project the video is in
workflowId?: string // the Google Flow workflow (project item) that holds the video
workflowStepId?: string // the workflow step, e.g. "CAE" (left out when Google's record has none)
mediaMetadata: { // Google's record of the video
createTime?: string // ISO 8601 time Google created the video
mediaTitle?: string // the prompt, as Google Flow titles the video (an upscale has none)
mediaBlobSize?: string // the MP4's size in bytes, as a string, once the video is done
mediaStatus: { // whether the video was made
mediaGenerationStatus: string // MEDIA_GENERATION_STATUS_PENDING | MEDIA_GENERATION_STATUS_ACTIVE |
// MEDIA_GENERATION_STATUS_SUCCESSFUL | MEDIA_GENERATION_STATUS_FAILED |
// MEDIA_GENERATION_STATUS_UNKNOWN
error?: { // why the video failed
code: number // Google's error code
message: string // Google's reason, e.g. "PUBLIC_ERROR_IP_INPUT_IMAGE"
}
failureReasons?: string[] // Google's classifier labels for a failed video, e.g. "IP_PROHIBITED"
}
visibility?: string // "PRIVATE" (left out on a failed video)
requestData: { // what the video was made from, as Google echoes it
videoGenerationRequestData: { // the generation settings
backend: 'flow' // the video was made on `flow.google.com`
statusEnum: number | null // Google's raw status number: 6 queued, 1 and 2 running, 3 done, 4, 5 and 7 failed
aspectEnum: number | null // Google's raw aspect number: 2 landscape, 1 portrait
videoModelControlInput?: { // the model settings Google ran
videoModelName?: string // Google's own key for the model that ran
videoGenerationMode?: string // VIDEO_GENERATION_MODE_TEXT_TO_VIDEO | VIDEO_GENERATION_MODE_REFERENCE_TO_VIDEO |
// VIDEO_GENERATION_MODE_VIDEO_EXTENSION (left out for the other modes)
videoAspectRatio?: string // VIDEO_ASPECT_RATIO_LANDSCAPE | VIDEO_ASPECT_RATIO_PORTRAIT
videoResolution?: string // VIDEO_RESOLUTION_360P | VIDEO_RESOLUTION_720P | VIDEO_RESOLUTION_1080P |
// VIDEO_RESOLUTION_4K
}
}
promptInputs?: Array<{ // the prompt as Google received it (an upscale has none)
structuredPrompt: { // the prompt in parts
parts: Array<{ // a run of text, or an @-mention
text?: string // a run of prompt text
reference?: object // an @-mention: { media: { mediaId, handle } }, { audio: { mediaId, handle } } or { entity: { entityId, handle } }
}>
}
}>
clientPlatform?: string // "CLIENT_PLATFORM_WEB"
}
}
video: { // the video's details
generatedVideo?: { // how Google made it (left out until Google reports it)
seed: number // the seed Google used (0 when it reports none)
prompt: string // the prompt as Google ran it (Veo rewrites it), an empty string on an upscale
model: string // Google's own key for the model that ran
baseImageMediaGenerationId?: string // an empty string on every video so far
isLooped: false // always false
aspectRatio: string // VIDEO_ASPECT_RATIO_LANDSCAPE | VIDEO_ASPECT_RATIO_PORTRAIT
// (an empty string when Google reports none)
upsampleMetadata?: { // on an upscaled video
videoUpsampleResolution: string // VIDEO_UPSAMPLE_RESOLUTION_720P | VIDEO_UPSAMPLE_RESOLUTION_1080P
// (left out for 4K)
}
}
dimensions?: { // the clip's measurements (an upscaled clip has none)
length: string // the clip's length, e.g. "8s"
}
operation: { // the generation operation
name: string // the same as name
}
}
mediaGenerationId?: string // the id to pass to the other endpoints (upscale, extend, GIF, concatenate, assets), on every finished answer, left out of the 201 answer
videoUrl?: string // signed MP4 download URL, valid about 6 hours, once the video is done
thumbnailUrl?: string // signed JPEG thumbnail URL, valid about 6 hours
}
FlowCaptcha: the captcha in the tabs above.
{
service?: string // the provider whose token Google accepted: `CapSolver`, `AntiCaptcha`,
// `YesCaptcha`, `CapMonster`, `SolveCaptcha`, `2Captcha`, `EzCaptcha` or
// `UserProvided`. Always on a success answer
taskId?: string // that provider's task id (none for `UserProvided`)
durationMs?: number // ms from the first solve to the token used. Always on a success answer
error?: string // why no captcha token could be had, on a failed request
attempts: Array<{ // every solve tried, in order, failed ones included
service: string // the provider asked
taskId?: string // that provider's task id
durationMs: number // how long this solve took, in ms
success: boolean // true when the provider returned a token (Google may still have refused it)
error?: string // why the solve failed
userAgent?: string // the browser user agent the provider solved with, when it reports one
secChUa?: string // the Sec-CH-UA value the provider solved with, when it reports one (may be empty)
cost?: string // the provider's price for this solve, as the provider reports it
ip?: string // the IP address the provider reports for this solve
createTime?: number // Unix time the provider started the solve, as it reports it
endTime?: number // Unix time the provider finished the solve, as it reports it
solveCount?: number // the provider's own solve counter for this task
}>
}
FlowReference: the source video and each reference image or character in request above.
{
user: number // your useapi.net user id, read from the reference
email: string // the Google account the media belongs to, read from the reference
type: 'image' | 'video' | 'character' // what the reference points to
id: string // Google's media id (image or video), or the character's entity id
referenceId: string // the reference you sent
meta?: { // characters only
imgs: number // how many images the character holds (they count toward the model's image limit)
voiceWorkflowId?: string // the voice attached to the character, when it has one
}
}
Missing media URLs
Media URL fields are optional and can be absent even when generation succeeded. When videoUrl, thumbnailUrl, fifeUrl, servingBaseUri, previewUrl or audioUrl is missing, the media itself is fine — only the download link could not be produced at that moment.
This is rare. Across the seven days of request logs we keep, it happened on one day only — twice, for about four hours and about forty minutes — and not at all on the other six. Google issues those links from an endpoint that limits how often it will answer a given network address, so it is Google limiting our outbound calls rather than useapi.net limiting you, and nothing you do triggers it. While it lasts it affects every account generating at that moment, then clears on its own. Your generation still completed and was charged as usual.
On a media item that generated successfully — mediaStatus.mediaGenerationStatus is MEDIA_GENERATION_STATUS_SUCCESSFUL — a missing URL means “not yet”, not “failed”, so read the field before using it and treat its absence as a retry condition. A media item that failed generation never carries a URL, and retrying will not produce one.
const url = media.videoUrl;
if (!url) {
// Not an error — the link is not available yet. See the options below.
}
How to get the link
Which route to use depends on whether you can wait.
If you are already polling the job, do nothing special. Completed video jobs re-resolve missing URLs automatically on GET /jobs/jobId, and the recovered link is saved, so a later poll returns it with no extra work on your side. This applies to video jobs created within the last 24 hours. Once the job is completed and a URL is still missing, leave at least a minute between polls — a job re-resolves at most once a minute, and the block clears only once traffic stops, so a tight retry loop lengthens the wait rather than shortening it.
If you hold a mediaGenerationId but no longer have the job, ask for that one media again with GET /assets/mediaGenerationId. That endpoint says which case you are in rather than leaving you to guess. A 503 with a Retry-After header means the link is coming and tells you how long to wait, so wait that long and ask again. A 404 means Google has no such media, and no amount of retrying will change it.
If you cannot wait, download the video through us with GET /assets/mediaGenerationId?raw=true. It reads the media over a different Google route that the block does not touch, so it works immediately and keeps working while the other two return nothing. It is video only.
Prefer the two link-based routes when you can. They hand you a link and you download straight from Google. The raw form moves the whole file through useapi.net on every call, which makes it a way out of a stuck download rather than your normal download path.
Characters and voices resolve their URLs as they are read, so simply requesting GET /characters/ref or GET /voices/ref again is enough. Wait a minute before retrying — a response that came back without its URL is held briefly, so an immediate repeat returns the same one.
None of this applies to images. Whenever an image URL is missing, POST /images puts the image itself in the response instead, base64-encoded in encodedImage — so you already have the picture and there is nothing to retry.
Examples
-
# First generate a video curl -X POST \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"prompt": "A serene mountain landscape at sunset"}' \ "https://api.useapi.net/v1/google-flow/videos" > generate.json # Extract mediaGenerationId from the response MEDIA_ID=$(jq -r '.media[0].mediaGenerationId' generate.json) # Extend the video curl -X POST \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d "{\"mediaGenerationId\": \"$MEDIA_ID\", \"prompt\": \"The camera rises above the mountains as the sun sets behind them\"}" \ "https://api.useapi.net/v1/google-flow/videos/extend" > extend.json # Extract extended video URL and download VIDEO_URL=$(jq -r '.media[0].videoUrl' extend.json) curl "$VIDEO_URL" --output extended_video.mp4 -
const token = 'YOUR_API_TOKEN'; // First generate a video const generateResponse = await fetch('https://api.useapi.net/v1/google-flow/videos', { method: 'POST', headers: { 'Authorization': `Bearer ${token}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ prompt: 'A serene mountain landscape at sunset' }) }); const generated = await generateResponse.json(); // Prefer media[] over deprecated operations[] const mediaGenerationId = generated.media[0].mediaGenerationId; // Extend the video const extendResponse = await fetch('https://api.useapi.net/v1/google-flow/videos/extend', { method: 'POST', headers: { 'Authorization': `Bearer ${token}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ mediaGenerationId, prompt: 'The camera rises above the mountains as the sun sets behind them' }) }); const extended = await extendResponse.json(); // Prefer media[] over deprecated operations[] const videoUrl = extended.media[0].videoUrl; // Download extended video (Node.js) const videoResponse = await fetch(videoUrl); const videoBuffer = await videoResponse.arrayBuffer(); require('fs').writeFileSync('extended_video.mp4', Buffer.from(videoBuffer)); console.log('Extended video saved!'); -
import requests token = 'YOUR_API_TOKEN' headers = { 'Authorization': f'Bearer {token}', 'Content-Type': 'application/json' } # First generate a video generate_response = requests.post( 'https://api.useapi.net/v1/google-flow/videos', headers=headers, json={'prompt': 'A serene mountain landscape at sunset'} ) generated = generate_response.json() # Prefer media[] over deprecated operations[] media_generation_id = generated['media'][0]['mediaGenerationId'] # Extend the video extend_response = requests.post( 'https://api.useapi.net/v1/google-flow/videos/extend', headers=headers, json={ 'mediaGenerationId': media_generation_id, 'prompt': 'The camera rises above the mountains as the sun sets behind them' } ) extended = extend_response.json() # Prefer media[] over deprecated operations[] video_url = extended['media'][0]['videoUrl'] # Download extended video video_response = requests.get(video_url) with open('extended_video.mp4', 'wb') as f: f.write(video_response.content) print('Extended video saved!')