Tripo3D

Text to Image

http
Base URL: https://openapi.tripo3d.ai/v3
Endpoint: POST /generation/text-to-image
Generate an image from a text prompt. Does not accept reference images — use image-to-image for that.
Note
  • This endpoint requires an API Key. Include it in the Authorization header as Bearer {api_key}.
  • This is an asynchronous API. After submitting the request, use the Task Query API to poll for results, or configure a Webhook to receive automatic notifications when the task completes.

Request Parameters

Request Body

modelstringdefault: seedream_v4
Image generation model. Available models:
  • seedream_v5 — latest quality, stronger prompt following.
  • seedream_v4 — default balanced model.
  • banana — fast generation.
  • banana_pro — higher quality.
  • banana2 — latest fast option.
  • chat_image_1 — base image model.
  • chat_image_1.5 — higher quality.
  • chat_image_2 — latest, best quality.
  • seedream_v5 — latest quality, stronger prompt following.
  • seedream_v4 — default balanced model.
promptstringRequired
Text prompt for image generation. Supports Chinese and English.
Notes
  • Recommended: ≤ 300 Chinese characters or ≤ 600 English words.
  • Put the most important elements first.
  • Negative prompts: append after --no.
sizestringdefault: 2048x2048
Output image size. Accepts semantic keywords (e.g. 2K / 4K) or explicit WxH pixels (e.g. 2048x2048). Supported values vary by model — see tabs below.
Pick exactly one of the two ways below — they cannot be combined.
  • Resolution tier: 2K / 3K. Describe the aspect ratio / shape in the prompt; the model decides the exact dimensions.
  • Explicit pixels: WxH (default 2048x2048). Total pixels 3.69–10.40 MP, aspect ratio [1:16, 16:1].
aspect_ratiostringdefault: 1:1
Output aspect ratio. Default 1:1 when omitted (banana series only; filled by the gateway when both size and aspect_ratio are absent).
  • banana / banana_pro: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9.
  • banana2 additionally supports 1:8, 1:4, 4:1, 8:1.
Only the banana series supports this field. seedream / chat_image generate by size — use the size parameter instead.
output_formatstringdefault: png
Output image format.
  • png — lossless, supports transparency.
  • jpeg — smaller file size, no transparency.
watermarkbooleandefault: false
Add an AI-generated content watermark. Only effective for the seedream series; the banana series always embeds a non-removable invisible watermark, and the chat_image series has no watermark control.
templatestring
Generation template.
  • asset_extraction — extract a subject from a scene.
  • character_completion — complete a partial character.
  • t_pose — generate a character in T-pose.
  • variants — generate design variations.
  • figure — generate a full-body figure.

Examples

seedream_v5
{
  "prompt": "A high-fashion editorial portrait, dramatic studio lighting.",
  "model": "seedream_v5",
  "size": "2K",
  "output_format": "png",
  "watermark": false
}
banana
{
  "prompt": "A cinematic product render of a glass sneaker on a dark stage.",
  "model": "banana",
  "size": "1248x832",
  "output_format": "png"}
banana_pro
{
  "prompt": "A cinematic product render of a glass sneaker on a dark stage.",
  "model": "banana_pro",
  "size": "2K",
  "aspect_ratio": "3:2",
  "output_format": "png"}
Create task
{
  "code": 0,
  "data": {
    "task_id": "task_abc123"}
}
Task result
{
  "code": 0,
  "data": {
    "task_id": "task_abc123",
    "type": "generate_image",
    "status": "success",
    "progress": 100,
    "output": {
      "generated_image": "https://cdn.tripo3d.ai/output/image.png",
      "size": "2048x2048"},
    "credits_consumed": 20,
    "created_at": "2026-04-28T12:00:00Z",
    "completed_at": "2026-04-28T12:00:08Z"}
}