Tripo3D

Image to Image

http
Base URL: https://openapi.tripo3d.ai/v3
Endpoint: POST /generation/image-to-image
Generate or edit an image from reference images. Supports editing, style transfer, and multi-image fusion.
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_v5
Image editing model.
  • seedream_v5 — strongest editing, style transfer, and multi-image fusion.
  • banana — fast editing.
  • banana_pro — higher quality editing.
  • banana2 — latest fast editing.
  • chat_image_1 — base image editing.
  • chat_image_1.5 — higher quality editing.
  • chat_image_2 — latest, best editing.
  • seedream_v5 — strongest editing, style transfer, and multi-image fusion.
inputstringRequired
Primary reference image. Accepts a public URL, file_token, or task_id.
Choose exactly one — do not pass multiple types simultaneously.
  • Single: input. Multiple: inputs, up to 4.
  • Accepted: public URL, file_token, or image task output.
Notes
  • Formats: jpeg, png (recommended); webp is rejected on some provider routes
  • Max file size: 20 MB
  • Max total pixels: 6000 × 6000 = 36 MP
  • Min width/height: 14 px
  • Aspect ratio (W/H): [1/3, 3]
  • URL images must be publicly accessible. Private files require /v3/files first.
inputsstring[]
Multiple reference images. Each follows the same format as input.
  • Single: input. Multiple: inputs, up to 4.
  • Accepted: public URL, file_token, or image task output.
Notes
  • Max: 4 (seedream), 10 (banana), 16 (chat_image)
  • Reference: image[1], image[2], etc.
promptstringConditional
Editing instruction. Required when no template is specified.
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.
templatestring
Editing template. When set, prompt becomes optional.
  • t_pose — convert to T-pose.
  • character_completion — complete a partial character.
  • 3d_enhance — enhance for 3D generation.
  • variants — generate design variations.
  • figure — generate a full-body figure.
output_formatstringdefault: png
Output image format.
  • png — lossless, supports transparency.
  • jpeg — smaller file size, no transparency.

Examples

Single image
{
  "input": "https://example.com/reference.png",
  "prompt": "Change the silver outfit into transparent glass.",
  "model": "seedream_v5",
  "size": "2K"}
Multi-image
{
  "inputs": [
    "https://example.com/photo1.png",
    "https://example.com/photo2.png"],
  "prompt": "Use character from image[1] and outfit from image[2].",
  "model": "seedream_v5"}
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"}
}