Dreamina API v1
REST API for ByteDance Dreamina (CapCut) — Seedance video models and Seedream image models, with asset upload, image and video upscale, frame interpolation and a job scheduler.
OpenAPI Specification
# Derived from the first-party useapi.net Postman collection: https://useapi.net/assets/postman/dreamina-v1.json
# method: derived | no operation, path, parameter or example was invented.
openapi: 3.1.0
info:
title: Dreamina API v1 by useapi.net
version: 1.0.0
description: "Experimental API for Dreamina by ByteDance. Video models: Seedance 2.0 (US+CA; 1080p CA-only), 2.0 Fast (US+CA),\
\ 1.5 Pro (US+CA), 1.0 Pro (CA), 1.0 Mini (US+CA), 1.0 Fast (CA), Sora2 (CA). Image models: Seedream 5.0 Lite, 4.6, 4.5,\
\ 4.1, 4.0, Nano Banana, 3.0, GPT Image 2 (CA only). Supports US and CA regions, 720p/1080p resolution, video upscale\
\ (2x super resolution).\n\n**Features:**\n\n- Multiple Dreamina accounts with automated load balancing\n \n- Real-time\
\ webhooks for job events (replyUrl parameter)\n \n- Async image and video generation with job polling\n \n- Dynamic\
\ concurrency management\n \n- Image upload for reference frame and image generation support\n \n\n**Commands:**\n\
\n- [POST /accounts](https://useapi.net/docs/api-dreamina-v1/post-dreamina-accounts) - Configure Dreamina account\n \
\ \n- [GET /accounts](https://useapi.net/docs/api-dreamina-v1/get-dreamina-accounts) - List all configured accounts\n\
\ \n- [GET /accounts/<account>](https://useapi.net/docs/api-dreamina-v1/get-dreamina-accounts-account) - Get account\
\ details, models, credits\n \n- [DELETE /accounts/<account>](https://useapi.net/docs/api-dreamina-v1/delete-dreamina-accounts-account)\
\ - Delete account configuration\n \n- [POST /assets/<account>](https://useapi.net/docs/api-dreamina-v1/post-dreamina-assets-account)\
\ - Upload images (JPEG, PNG, WebP)\n \n- [GET /assets/<account>](https://useapi.net/docs/api-dreamina-v1/get-dreamina-assets-account)\
\ - List generation history\n \n- [DELETE /assets/<assetId>](https://useapi.net/docs/api-dreamina-v1/delete-dreamina-assets-assetid)\
\ - Delete asset from history\n \n- [POST /videos](https://useapi.net/docs/api-dreamina-v1/post-dreamina-videos) -\
\ Generate videos\n \n- [GET /videos/<jobid>](https://useapi.net/docs/api-dreamina-v1/get-dreamina-videos-jobid) -\
\ Get video job status and results\n \n- [POST /images](https://useapi.net/docs/api-dreamina-v1/post-dreamina-images)\
\ - Generate images\n \n- [GET /images/<jobid>](https://useapi.net/docs/api-dreamina-v1/get-dreamina-images-jobid)\
\ - Get image job status and results\n \n- [POST /videos/upscale](https://useapi.net/docs/api-dreamina-v1/post-dreamina-videos-upscale)\
\ - Upscale video (2x super resolution)\n \n- [POST /videos/interpolate](https://useapi.net/docs/api-dreamina-v1/post-dreamina-videos-interpolate)\
\ - Frame interpolation (30/60 FPS)\n \n- [POST /images/upscale](https://useapi.net/docs/api-dreamina-v1/post-dreamina-images-upscale)\
\ - Upscale generated image\n \n- [GET /scheduler](https://useapi.net/docs/api-dreamina-v1/get-dreamina-scheduler)\
\ - List executing jobs\n \n- [DELETE /scheduler/<jobid>](https://useapi.net/docs/api-dreamina-v1/delete-dreamina-scheduler-jobid)\
\ - Cancel executing job\n \n\nVisit [https://useapi.net/docs/api-dreamina-v1](https://useapi.net/docs/api-dreamina-v1)\
\ for complete documentation.\n\n---\n**Updated:** February 23, 2026 (April 17, 2026)"
contact:
name: useapi.net support
email: support@useapi.net
url: https://useapi.net/docs/support
x-derived-from: https://useapi.net/assets/postman/dreamina-v1.json
externalDocs:
description: dreamina documentation
url: https://useapi.net/docs/api-dreamina-v1
servers:
- url: https://api.useapi.net/v1/dreamina
security:
- bearerAuth: []
tags:
- name: dreamina
description: Dreamina API v1 by useapi.net
paths:
/accounts:
post:
operationId: postAccounts
summary: POST accounts
description: 'Configure your Dreamina account for API access using email and password credentials.
See [Setup Dreamina](https://useapi.net/docs/start-here/setup-dreamina) for detailed instructions.
[Documentation](https://useapi.net/docs/api-dreamina-v1/post-dreamina-accounts)'
tags:
- dreamina
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
email:
type: string
password:
type: string
region:
type: string
example:
email: your-dreamina-email@example.com
password: your-dreamina-password
region: US
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
get:
operationId: getAccounts
summary: GET accounts
description: 'List all configured Dreamina accounts.
[Documentation](https://useapi.net/docs/api-dreamina-v1/get-dreamina-accounts)'
tags:
- dreamina
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/accounts/{account}:
get:
operationId: getAccountsByAccount
summary: GET accounts/<account>
description: 'Get configuration details for a specific Dreamina account, including session status, available models,
and credit balance. Can also be called once a day to claim free daily credits.
[Documentation](https://useapi.net/docs/api-dreamina-v1/get-dreamina-accounts-account)'
tags:
- dreamina
parameters:
- name: account
in: path
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
delete:
operationId: deleteAccountsByAccount
summary: DELETE accounts/<account>
description: 'Delete a configured Dreamina account. Removes the account from your configuration and cleans up any executing
job entries.
[Documentation](https://useapi.net/docs/api-dreamina-v1/delete-dreamina-accounts-account)'
tags:
- dreamina
parameters:
- name: account
in: path
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/assets/{account}:
post:
operationId: postAssetsByAccount
summary: POST assets/<account>
description: 'Upload images to Dreamina for use as reference frames in video and image generation.
Supports JPEG, PNG, and WebP formats up to 10 MB. Returns assetRef for use in POST /videos and POST /images.
[Documentation](https://useapi.net/docs/api-dreamina-v1/post-dreamina-assets-account)'
tags:
- dreamina
parameters:
- name: account
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/octet-stream:
schema:
type: string
format: binary
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
get:
operationId: getAssetsByAccount
summary: GET assets/<account>
description: 'List generation history (images and videos) for a specific account. Returns assets with their URLs, dimensions,
and reusable assetRef values for POST /images or as in POST /videos.
[Documentation](https://useapi.net/docs/api-dreamina-v1/get-dreamina-assets-account)'
tags:
- dreamina
parameters:
- name: account
in: path
required: true
schema:
type: string
- name: count
in: query
required: true
schema:
type: string
description: 'Number of assets to return (1-100, default: 20). Optional.'
example: '20'
- name: offset
in: query
required: false
schema:
type: string
description: Pagination cursor from previous response's nextOffset. Optional.
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/assets/{assetId}:
delete:
operationId: deleteAssetsByAssetid
summary: DELETE assets/<assetId>
description: 'Delete a specific asset (image or video) from generation history.
[Documentation](https://useapi.net/docs/api-dreamina-v1/delete-dreamina-assets-assetid)'
tags:
- dreamina
parameters:
- name: assetId
in: path
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/videos:
post:
operationId: postVideos
summary: POST videos
description: 'Generate videos using Dreamina AI models. Supports text-to-video, first frame (I2V), end frame, and multi-frame
keyframe modes.
Async by default — returns immediately with a job ID. Poll GET /videos/<jobid> for completion.
[Documentation](https://useapi.net/docs/api-dreamina-v1/post-dreamina-videos)'
tags:
- dreamina
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
prompt:
type: string
model:
type: string
account:
type: string
ratio:
type: string
duration:
type: string
resolution:
type: string
firstFrameRef:
type: string
endFrameRef:
type: string
frame_1_imageRef:
type: string
frame_1_prompt:
type: string
frame_1_duration:
type: string
frame_2_imageRef:
type: string
frame_2_prompt:
type: string
frame_2_duration:
type: string
replyUrl:
type: string
replyRef:
type: string
maxJobs:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/videos/{jobid}:
get:
operationId: getVideosByJobid
summary: GET videos/<jobid>
description: 'Retrieve the status and result of a video generation job. Poll this endpoint after POST /videos. Jobs
are retained for 30 days.
When status is ''completed'', response.videoUrl contains the download URL.
[Documentation](https://useapi.net/docs/api-dreamina-v1/get-dreamina-videos-jobid)'
tags:
- dreamina
parameters:
- name: jobid
in: path
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/videos/upscale:
post:
operationId: postVideosUpscale
summary: POST videos/upscale
description: 'Upscale a generated video to 2x resolution (super resolution). Doubles width and height — 720p becomes
1440p, 1080p becomes 4K. Each video can only be upscaled once.
Poll GET /videos/<jobid> for the upscaled result.
[Documentation](https://useapi.net/docs/api-dreamina-v1/post-dreamina-videos-upscale)'
tags:
- dreamina
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
jobid:
type: string
replyUrl:
type: string
replyRef:
type: string
maxJobs:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/videos/interpolate:
post:
operationId: postVideosInterpolate
summary: POST videos/interpolate
description: 'Interpolate a generated video to 30 or 60 FPS (from 24 FPS source). Works on both original and upscaled
videos. Each video can only be interpolated once.
Poll GET /videos/<jobid> for the interpolated result.
[Documentation](https://useapi.net/docs/api-dreamina-v1/post-dreamina-videos-interpolate)'
tags:
- dreamina
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
jobid:
type: string
fps:
type: string
replyUrl:
type: string
replyRef:
type: string
maxJobs:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/images:
post:
operationId: postImages
summary: POST images
description: 'Generate images using Dreamina AI models from text prompts with optional reference images. Each generation
produces up to 4 images.
Async by default — returns immediately with a job ID. Poll GET /images/<jobid> for completion.
[Documentation](https://useapi.net/docs/api-dreamina-v1/post-dreamina-images)'
tags:
- dreamina
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
prompt:
type: string
model:
type: string
account:
type: string
ratio:
type: string
resolution:
type: string
imageRef_1:
type: string
imageRef_2:
type: string
imageRef_3:
type: string
imageStrength:
type: string
replyUrl:
type: string
replyRef:
type: string
maxJobs:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/images/{jobid}:
get:
operationId: getImagesByJobid
summary: GET images/<jobid>
description: 'Retrieve the status and result of an image generation or upscale job. Poll this endpoint after POST /images
or POST /images/upscale. Jobs are retained for 30 days.
When status is ''completed'', response.images contains the generated images with URLs and assetRef values.
[Documentation](https://useapi.net/docs/api-dreamina-v1/get-dreamina-images-jobid)'
tags:
- dreamina
parameters:
- name: jobid
in: path
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/images/upscale:
post:
operationId: postImagesUpscale
summary: POST images/upscale
description: 'Upscale a generated image to higher resolution (2K, 4K, or 8K). Requires a completed image generation
job from POST /images.
Poll GET /images/<jobid> for the result.
[Documentation](https://useapi.net/docs/api-dreamina-v1/post-dreamina-images-upscale)'
tags:
- dreamina
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jobid:
type: string
imageIndex:
type: integer
upscaleResolution:
type: string
example:
jobid: ''
imageIndex: 0
upscaleResolution: 4k
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/scheduler:
get:
operationId: getScheduler
summary: GET scheduler
description: 'List all currently executing (in-progress) image and video generation jobs, grouped by account.
[Documentation](https://useapi.net/docs/api-dreamina-v1/get-dreamina-scheduler)'
tags:
- dreamina
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/scheduler/{jobid}:
delete:
operationId: deleteSchedulerByJobid
summary: DELETE scheduler/<jobid>
description: 'Cancel an executing job. If the job is still in ''created'' status, it will be marked as failed with reason
''Cancelled by user''.
[Documentation](https://useapi.net/docs/api-dreamina-v1/delete-dreamina-scheduler-jobid)'
tags:
- dreamina
parameters:
- name: jobid
in: path
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'useapi.net API token. Header: `Authorization: Bearer user:<number>-<unique-string>`. Use the complete
token including the `user:` prefix.'