Skip to content

JiMeng 3.0 - Image Generation

Overview

    • Method: POST
    • Path: /v1/images/generations
    • Content-Type: application/json

Authentication

  • Authorization: Bearer sk-xxx (required)

Request Example

HeaderExampleRequired
Content-Typeapplication/jsonYes
AuthorizationBearer sk-xxxxYes

Request Body (JSON)

json
{
  "model": "doubao-seedream-3-0-t2i-250415",
  "prompt": "DD style, OC renderer, trendy toy style, porcelain; porcelain figure (black-haired model wearing a 3D batik embroidered Miao short skirt, skirt hem like blooming crown, panoramic composition showing cool white skin and flowing wave patterns in the skirt; batik patterns and silver head crown create 3D echo with batik embroidery, barefoot standing. Matte fabric shifts pearl luster in cool-toned light. Fusion with Western oil painting texture) on raw rice paper with blush gradient on the face, full body.",
  "response_format": "url",
  "size": "864x1152",
  "seed": 12345,
  "guidance_scale": 2.5,
  "watermark": false
}

Parameter Description

ParameterTypeRequiredDefaultDescription
promptstringYes-Prompt for image generation, supports Chinese and English
modelstringYes-Model name, e.g. doubao-seedream-3-0-t2i-250415
response_formatstringNourlOutput format, url or b64_json
sizestringNo1024x1024Image size, recommended 1024x1024 864x1152 1152x864 1280x720 720x1280 832x1248 1248x832 1512x648
seedintegerNo-Random seed, [-1,2147483647]
guidance_scalenumberNo2.5Consistency level, 1-10
watermarkbooleanNofalseAdd watermark

Response Example (200)

json
{
  "model": "doubao-seedream-3-0-t2i-250415",
  "created": 1748334192,
  "data": [
    {
      "url": "https://ark-content-generation-v2-cn-beijing.tos-cn-beijing.volces.com/doubao-seedream-3-0-t2i/0217483341891267365728335807c27305757677c12880620da91.jpeg?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYjg3ZjNlOGM0YzQyNGE1MmI2MDFiOTM3Y2IwMTY3OTE%2F20250527%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20250527T082312Z&X-Tos-Expires=86400&X-Tos-Signature=82b5f59cd2c306850ed9a6649a0a9fa4311ed356ad0ba1adbe11a46dea779bde&X-Tos-SignedHeaders=host&x-tos-process=image%2Fwatermark%2Cimage_YXNzZXRzL3dhdGVybWFyay5wbmc_eC10b3MtcHJvY2Vzcz1pbWFnZS9yZXNpemUsUF83"
    }
  ],
  "usage": {
    "generated_images": 1
  }
}