Retrieve Job Status
March 2, 2026 (November 13, 2026)
Table of contents
Retrieve the status and result of a video generation, upscale, or interpolation job by its job ID.
Use this endpoint to poll for completion after submitting a video via POST /videos, POST /videos/full-quality, POST /videos/upscale, or POST /videos/interpolate. Jobs are retained for 30 days.
https://api.useapi.net/v1/dreamina/videos/
jobid
Request Headers
Authorization: Bearer {API token}
API tokenis required, see Setup useapi.net for details.
Path Parameters
jobidis required, the unique job identifier returned from POST /videos, POST /videos/full-quality, POST /videos/upscale, or POST /videos/interpolate.
Responses
-
Returns the job record with current status and details.
Processing (status: created):
{ "jobid": "j0223140530123456789v-u12345-CA:[email protected]:dreamina", "type": "video", "status": "created", "model": "seedance-2.0", "created": "2026-02-23T14:05:30.123Z", "request": { "prompt": "A serene mountain landscape at sunset", "model": "seedance-2.0", "ratio": "16:9", "duration": 5, "inputMode": "prompt" }, "response": { "forecastCost": 125 }, "code": 200 }Completed:
{ "jobid": "j0223140530123456789v-u12345-CA:[email protected]:dreamina", "type": "video", "status": "completed", "model": "seedance-2.0", "created": "2026-02-23T14:05:30.123Z", "updated": "2026-02-23T14:07:15.456Z", "request": { "prompt": "A serene mountain landscape at sunset", "model": "seedance-2.0", "ratio": "16:9", "duration": 5, "inputMode": "prompt" }, "response": { "assetId": "CA:[email protected]:7341234567890123456", "videoUrl": "https://v16m-default.tiktokcdn.com/...", "videoUrlBackup": "https://v16m.byteicdn.com/...", "videoUrlWatermarked": "https://v16-cc.capcut.com/...", "watermarked": false, "videoId": "7341234567890123456", "coverUrl": "https://p9-sign.douyinpic.com/...", "width": 1280, "height": 720, "durationMs": 5042, "hasAudio": false, "forecastCost": 125, "finishTime": 1708700835 }, "code": 200 }Failed:
{ "jobid": "j0223140530123456789v-u12345-CA:[email protected]:dreamina", "type": "video", "status": "failed", "model": "seedance-2.0", "created": "2026-02-23T14:05:30.123Z", "updated": "2026-02-23T14:07:15.456Z", "request": { "prompt": "A test prompt", "model": "seedance-2.0", "ratio": "16:9", "duration": 5, "inputMode": "prompt" }, "error": "fail_code: 2043", "errorDetails": "OutputVideoRisk", "failMsg": "OutputVideoRisk", "code": 2043 }Note: Jobs older than 1 hour that are still
createdare auto-marked as failed with"Generation timed out"(code408).errorDetailsis the sentence Dreamina’s website shows, and it reads the same for different filters.failMsgis Dreamina’s own name for the failure, so you can tell them apart. Common values, all raised after submission — a job that fails this way is not charged:codefailMsgMeaning Retry? 2038InputTextRiskDreamina’s content filter refused the prompt No: change the prompt 2039InputImageRiskDreamina’s content filter refused a reference image No: replace the image 2048InputImageCopyrightA reference image looks like protected content No: replace the image 18000ParamImageRatioInvalidThe reference image’s aspect ratio is too wide or too narrow for the model: crop or pad it to a less extreme shape No: replace the image 2043OutputVideoRiskThe generated video failed content moderation No: change the prompt 2045OutputAudioRiskThe generated audio failed content moderation No: change the prompt 2052OutputAudioCopyrightThe sound generated with the video was flagged as copyrighted No: change the prompt 2053OutputVideoCopyrightThe video may contain third-party content. Judged against the finished video, so a prompt naming no person or property can still trigger it by describing something recognisable — a costumed character, a trademarked location, or a figure written as an unmistakable celebrity. Real human faces and stylised violence do not trigger it No: change the prompt -
Invalid API token.
{ "error": "Unauthorized" } -
Job not found, belongs to a different user, or has expired (>30 days).
{ "error": "Job not found" }
Model
-
Video generation completed. Includes video URL and metadata.
{ jobid: string // Unique job identifier type: 'video' | 'video-upscale' | 'video-interpolate' // Job type status: 'completed' model: string // Model used created: string // ISO 8601 timestamp updated: string // ISO 8601 timestamp request: { prompt?: string model: string ratio?: string duration?: number inputMode: string // "prompt" | "first_frame" | "end_frame" | "multi_frame" | "unified_edit" | "long_video" | "edit" | "full_quality" resolution?: string // "480p", "720p", "1080p", "2k" or "4k" draftJobid?: string // full_quality only: the seedance-2.5-draft job it was made from firstFrameRef?: string endFrameRef?: string editVideoRef?: string frame_1_imageRef?: string // Keyframe refs (multi_frame mode) frame_1_prompt?: string frame_1_duration?: number frame_2_imageRef?: string frame_2_prompt?: string frame_2_duration?: number replyUrl?: string replyRef?: string } response: { assetId: string // For DELETE /assets/<assetId> videoUrl: string // Direct MP4 URL — clean (non-watermarked) master when available; falls back to the watermarked variant for models that don't expose a master videoUrlBackup?: string // Alternate CDN host for the same master (use if primary fails) videoUrlBackups?: string[] // Full list of alternate master URLs when more than one is provided videoUrlWatermarked?: string // Watermarked variant, preserved as a fallback and for compliance/traceability of AI-generated content watermarked?: boolean // true when the returned videoUrl carries Dreamina's AIGC transparency badge videoId: string // Dreamina video ID coverUrl: string // Video cover/thumbnail URL width: number // Video width in pixels height: number // Video height in pixels durationMs: number // Video duration in milliseconds hasAudio: boolean // Whether video has audio forecastCost: number // Estimated generation time in seconds, NOT a price finishTime: number // Unix timestamp of completion upscaleJobid?: string // Set after POST /videos/upscale } code: number // 200 }Watermark handling
Dreamina’s backend renders every generated video twice:
- A clean master served from
v16m-default.tiktokcdn.com/v16m.byteicdn.com. - A watermarked transcode served from
v16-cc.capcut.comwith a baked-in top-left “AI” transparency badge and (on non-premium accounts) a bottom-right Dreamina brand mark.
GET /videos/<jobid>returns the clean master asvideoUrlwhenever the upstream response exposes one, and keeps the watermarked URL invideoUrlWatermarkedas a fallback. Thewatermarkedflag reflects which variantvideoUrlis currently pointing at.For models that don’t expose a master,
videoUrlfalls back to the watermarked variant andwatermarkedbecomestrue. The watermark is baked into the MP4 at render time — there is no URL parameter that strips it from the watermarked variant, and attempting to edit the URL invalidates its signature.All video URLs are signed and expire ~7 days after generation. Download promptly.
- A clean master served from
-
Video generation failed. Includes error details.
{ jobid: string // Unique job identifier type: 'video' | 'video-upscale' | 'video-interpolate' status: 'failed' model: string created: string // ISO 8601 timestamp updated: string // ISO 8601 timestamp request: { prompt?: string model: string ratio?: string duration?: number inputMode: string firstFrameRef?: string endFrameRef?: string editVideoRef?: string replyUrl?: string replyRef?: string } error: string // Error summary (e.g., "fail_code: 2043") errorDetails?: string // Additional details (e.g., "OutputVideoRisk") failMsg?: string // Dreamina's own name for a failure, e.g. "OutputVideoRisk", "ParamImageRatioInvalid" code: number // Error code (e.g., 2043, 408, 596) }Common error codes:
Code Meaning 408 Generation timed out (>1 hour) 596 Account session expired 2038 Content filtered 2043 Output video moderation risk
Examples
-
# Get job status curl "https://api.useapi.net/v1/dreamina/videos/j0223140530123456789v-u12345-CA:[email protected]:dreamina" \ -H "Authorization: Bearer YOUR_API_TOKEN" # Poll for completion (check every 10 seconds) while true; do RESULT=$(curl -s "https://api.useapi.net/v1/dreamina/videos/$JOBID" \ -H "Authorization: Bearer YOUR_API_TOKEN") STATUS=$(echo "$RESULT" | jq -r '.status') echo "Status: $STATUS" if [[ "$STATUS" == "completed" ]]; then echo "$RESULT" | jq -r '.response.videoUrl' break fi if [[ "$STATUS" == "failed" ]]; then echo "$RESULT" | jq -r '.error' break fi sleep 10 done -
const apiToken = 'YOUR_API_TOKEN' const jobId = 'j0223140530123456789v-u12345-CA:[email protected]:dreamina' async function getJobStatus(jobId) { const response = await fetch(`https://api.useapi.net/v1/dreamina/videos/${jobId}`, { headers: { 'Authorization': `Bearer ${apiToken}` } }) return await response.json() } // Poll until completion async function waitForCompletion(jobId, intervalMs = 10000) { while (true) { const job = await getJobStatus(jobId) console.log(`Status: ${job.status}`) if (job.status === 'completed') { console.log('Video URL:', job.response.videoUrl) console.log('Dimensions:', `${job.response.width}x${job.response.height}`) console.log('Duration:', `${job.response.durationMs}ms`) return job } if (job.status === 'failed') { console.error('Job failed:', job.error) throw new Error(job.error) } await new Promise(resolve => setTimeout(resolve, intervalMs)) } } const job = await waitForCompletion(jobId) -
import requests import time api_token = 'YOUR_API_TOKEN' job_id = 'j0223140530123456789v-u12345-CA:[email protected]:dreamina' def get_job_status(job_id: str) -> dict: response = requests.get( f'https://api.useapi.net/v1/dreamina/videos/{job_id}', headers={'Authorization': f'Bearer {api_token}'} ) response.raise_for_status() return response.json() def wait_for_completion(job_id: str, interval_sec: int = 10) -> dict: while True: job = get_job_status(job_id) print(f"Status: {job['status']}") if job['status'] == 'completed': print(f"Video URL: {job['response']['videoUrl']}") print(f"Dimensions: {job['response']['width']}x{job['response']['height']}") # Download video video_response = requests.get(job['response']['videoUrl']) with open('output.mp4', 'wb') as f: f.write(video_response.content) print('Video saved to output.mp4') return job if job['status'] == 'failed': raise Exception(f"Job failed: {job.get('error')}") time.sleep(interval_sec) job = wait_for_completion(job_id)