Overview

Seedream accelerates concept development across games, animation, and film. Progress through multiple refinement stages, keep palettes consistent, and export sequences for downstream review.

Stage Workflow

Stages range from rough thumbnails to fully-rendered frames:

Stage	Output	Use case
`0`	Loose sketches	Rapid ideation.
`1`	Refined composition	Pitch decks, direction reviews.
`2`	Detailed render	Storyboards, key art.
`3`	Final polish	Delivery-ready concept art.

Sample Generation

curl -X POST "https://api.transendai.net/v1/images/seedream/generation" \
  -H "Authorization: Bearer $TRANSEND_API_KEY" \
  -H "Content-Type": "application/json" \
  -d '{
    "story_id": "expedition-01",
    "prompt": "Explorer enters a bioluminescent cave with ruins.",
    "palette": "bioluminescent-blues",
    "stage": 2,
    "aspect_ratio": "16:9",
    "frames": 4
  }'

story_id keeps a sequence coherent across calls.

Response Payload

{
  "frames": [
    {
      "frame_id": "expedition-01-001",
      "url": "https://edge.transendai.net/storyboards/expedition-01-001.png",
      "stage": 2,
      "palette": "bioluminescent-blues",
      "annotations_url": "https://console.transendai.net/stories/expedition-01/frames/001"
    }
  ],
  "usage": {
    "stage": 2,
    "credits": 4
  }
}

Palette Management

Create palettes through the dashboard or POST /palettes.
Each palette stores hex values and weighting.
Reuse palettes in prompts to maintain brand or project consistency.

Team Annotations

Reviewers can comment on each frame through the console. Call GET /stories/{id}/annotations to retrieve feedback and patch instructions for the next iteration.

Error Codes

Code	Explanation	Action
`400`	Invalid stage or aspect ratio.	Use stages 0–3 and a supported ratio (`1:1`, `3:2`, `16:9`, `9:16`).
`404`	Unknown palette ID.	Verify the palette exists in your workspace.
`409`	Concurrent edit conflict.	Fetch annotations and retry with latest revisions.

Best Practices

Start at stage 0 or 1 to nail composition quickly, then move to stage 2+ for detail.
Attach reference_images when you need precise character or asset consistency.
Export final frames as layered PSD using output_format: { "type": "psd" }.

Seedream landing page
Observability for pipeline health

Seedream API