Skip to main content
POST
https://gptproto.com
/
api
/
v3
/
vidu
/
viduq2
/
text-to-image
viduq2 (Text To Image)
curl --request POST \
  --url https://gptproto.com/api/v3/vidu/viduq2/text-to-image

​
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/vidu/viduq2/text-to-image' \
--header 'Authorization: GPTPROTO_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "prompt": "a cat",
  "aspect_ratio": "1:1",
  "resolution": "2K",
  "seed": 1
}'

​
Query Result

If the request that generated your content includes the parameter enable_sync_mode set to true (some models do not support this parameter, but you still need to query the result by id), you must call the Query Result endpoint to retrieve the final output. 
curl -X GET "https://gptproto.com/api/v3/predictions/{id}/result" \
  -H "Authorization: GPTPROTO_API_KEY" \
  -H "Content-Type: application/json"
After submitting your prediction request, the response will contain the id you need.
You can find it in either:
  • data.id – the unique identifier of the prediction
  • data.urls[0].get – a ready-to-use GET URL that already embeds the id
{
    "data": {
        "id": "abc",
        "model": "model_name",
        "outputs": [],
        "urls": {
            "get": "https://gptproto.com/api/v3/predictions/abc/result"
        },
        "status": "completed",
        "error": null,
        "executionTime": 0,
        "timings": {
            "inference": 0
        },
        "has_nsfw_contents": [],
        "created_at": "2026-01-01 00:00:00"
    },
    "message": "success",
    "code": 200
}

​
Parameters

ParameterTypeRequiredDefaultRangeDescription
promptstring✅ Yes--The text prompt for generating the image.
imagesarray✅ Yes-1~7 itemsThe reference image to guide the generation.
aspect_ratiostring❌ No1:11:1
16:9
9:16
4:3
3:4
21:9
2:3
3:2
auto		The aspect ratio for the generated image.
resolutionstring❌ No1080p1080p
2k
4k		The output resolution quality: 1080p (1920x1080), 2K (2560x1440), or 4K (3840x2160).
seedinteger❌ No11~2147483647The random seed to use for the generation. 1 means a random seed will be used.

​
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)