Skip to main content
POST
/
api
/
v3
/
contents
/
generations
/
tasks
dreamina-seedance-2-0-260128 (Reference To Video)
curl --request POST \
  --url https://gptproto.com/api/v3/contents/generations/tasks

Documentation Index

Fetch the complete documentation index at: https://docs.gptproto.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Authentication

  1. Sign up for a GPTProto account at https://gptproto.com
  2. Navigate to the API Keys section in your dashboard
  3. Generate a new API key (sk-xxxxx)
  4. Copy and securely store your API key For authentication details, please refer to the Authentication section.

​
Initiate Request

curl --location 'https://gptproto.com/api/v3/contents/generations/tasks' \
--header 'Authorization: GPTPROTO_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "model": "dreamina-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "A girl holding a fox, gentle breeze blowing through her hair, golden sunset light, cinematic, shallow depth of field"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://tos.gptproto.com/resource/cat.png"
      }
    }
  ],
  "generate_audio": true
}'

​
Query Result

curl -X GET "https://gptproto.com/api/v3/contents/generations/tasks/{id}" \
  -H "Authorization: GPTPROTO_API_KEY" \
  -H "Content-Type: application/json"

​
Response

{
    "id": "cgt-20251225195352-123",
    "model": "doubao-seedance-1-5-pro-251215",
    "status": "succeeded",
    "content": {
        "video_url": "https://example.com/video.mp4"
    },
    "usage": {
        "completion_tokens": 260100,
        "total_tokens": 260100
    },
    "seed": "16108",
    "resolution": "720p",
    "duration": 12,
    "ratio": "16:9",
    "created_at": "1766663633",
    "updated_at": "1766663715",
    "framespersecond": 24
}
Status Enum
StatusDescription
queuedQueued
runningRunning
succeededSucceeded
failedFailed
expiredExpired

​
Parameters

​
Core Parameters

ParameterTypeRequiredDefaultRangeDescription
modelstring✅ Yes--The ID of the model you want to call. You need to enable model service and query the Model ID. You can also call the model through Endpoint ID to get advanced capabilities such as rate limiting, billing type (prepaid/postpaid), running status query, monitoring, and security.
contentarray✅ Yes--Information input to the model for video generation, supporting text and image information.
>content.typestring✅ Yes-text
image_url		Type of input content. Use text for text input, image_url for image input (supports image URL or Base64 encoding).
>content.textstring✅ Yes (if type is text)--Text content input to the model, describing the expected video to be generated.
>content.image_urlobject✅ Yes (if type is image_url)--Image object input to the model.
>>content.image_url.urlstring✅ Yes (if image_url is used)--Image information, which can be an image URL or Base64 encoded image.
>content.rolestring❌ No-first_frame
last_frame
reference_image		Position or purpose of the image. Different roles correspond to different video generation scenarios. See Video Generation Scenarios for details.
generate_audioboolean❌ Notrue-Whether to include synchronized sound with the video. Only supported by Seedance 1.5 pro.

​
Advanced Parameters

Note: Different models may support different parameter options. For more details, please refer to the Model Field Compatibility table.
ParameterTypeRequiredDefaultRangeDescription
resolutionstring❌ No720p/1080p480p
720p
1080p		Video resolution. Default values vary by model.
ratiostring❌ No16:9/adaptive16:9
4:3
1:1
3:4
9:16
21:9
adaptive		Aspect ratio of the generated video.
durationinteger❌ No5[2, 12]Duration of the generated video in seconds.
framesinteger❌ No-[29, 289] (25+4n)Number of frames of the generated video.
framespersecondinteger❌ No2424Frame rate of the video in frames per second.
seedinteger❌ No-1[-1, 2^32-1]Seed integer for controlling randomness.
camerafixedboolean❌ Nofalse-Whether to fix the camera.
watermarkboolean❌ Nofalse-Whether to include watermark in the generated video.

​
Video Generation Scenarios

First frame video generation, first and last frame video generation, and reference image video generation are three mutually exclusive scenarios and cannot be mixed.
Note: Reference scenarios are only supported by Seedance 2.0. 
{
    "content": [
        {
            "type": "text",
            "text": "Multiple shots. A detective enters a dimly lit room. He examines the clues on the table and picks up an item. The camera shifts to him deep in thought. --ratio 16:9"
        }
    ]
}

​
Aspect Ratio & Resolution

Note: 1080p is not supported in reference image scene for Seedance 1.0 lite. 1080p is not supported for Seedance 2.0 fast.
ResolutionAspect RatioWidth x Height
Seedance 1.0		Width x Height
Seedance 1.5 pro
Seedance 2.0 & 2.0 fast
480p16:9864×480864×496
480p4:3736×544752×560
480p1:1640×640640×640
480p3:4544×736560×752
480p9:16480×864496×864
480p21:9960×416992×432
720p16:91248×7041280×720
720p4:31120×8321112×834
720p1:1960×960960×960
720p3:4832×1120834×1112
720p9:16704×1248720×1280
720p21:91504×6401470×630
1080p16:91920×10881920×1088
1080p4:31664×12481664×1248
1080p1:11440×14401440×1440
1080p3:41248×16641248×1664
1080p9:161088×19201088×1920
1080p21:92176×9282176×928

​
Error Codes

​
Common Error Codes

Error CodeError NameDescription
401UnauthorizedAPI key is missing or invalid
403ForbiddenYour API key doesn’t have permission to access this resource, or insufficient balance for the requested operation
429Too Many RequestsYou’ve exceeded your rate limit
500Internal server errorAn internal server error occurred
503Content policy violationContent blocked due to safety concerns (actual status code is 400)