VARIANT · Bytedance / Seedream

Seedream seedream-v4-text-to-image API

Same API key, same model skill workflow — switch variants by changing one model ID.

Operational · image · Commercial OK
runapi.ai
curl -X POST https://runapi.ai/api/v1/seedream/text_to_image \
  -H "Authorization: Bearer $RUNAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-v4-text-to-image",
  "prompt": "Create a social media graphic for a coffee shop sale with the text '50% OFF' in bold, warm tones, 4K."
}'
import { SeedreamClient } from "@runapi.ai/seedream";

const client = new SeedreamClient();
const result = await client.textToImage.run({
    model: "seedream-v4-text-to-image",
    prompt: "Create a social media graphic for a coffee shop sale with the text '50% OFF' in bold, warm tones, 4K.",
});
require "runapi/seedream"

client = RunApi::Seedream::Client.new
result = client.text_to_image.run(
    model: "seedream-v4-text-to-image",
    prompt: "Create a social media graphic for a coffee shop sale with the text '50% OFF' in bold, warm tones, 4K."
)
npx skills add runapi-ai/seedream -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp

# Codex
codex plugin install runapi-mcp@agents

# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
@runapi.ai/seedream v1
Switch variant
OVERVIEW

seedream-v4-text-to-image targets the sweet spot of quality and cost within the Seedream family.

  • Pay-per-call pricing in USD
  • Failed generations not charged
  • Streaming when supported by the model
  • Schema-validated tool calls
PRICING

Pricing

Failed generations are not charged
Text to image
$0.10 / image
SPEC SHEET

Technical details

Model ID seedream-v4-text-to-image
Provider Bytedance
Modality image
Task type asynchronous
Billing unit call
API endpoint /api/v1/seedream/text_to_image
Commercial license Yes — included via API
Status Operational
SKILLS

Model skill — seedream-v4-text-to-image

Install the skill once, then use the variant ID from this page while building.

# Install the model skill for app development workflows
npx skills add runapi-ai/seedream -g
Installs docs, schemas, pricing context, and setup notes into your developer workspace.
Or use this setup request in your coding tool:
Install the Seedream skill for this app:

1. Add runapi-ai/seedream with the skills installer.
2. Load SKILL.md in this workspace.
3. Use its docs, schemas, pricing notes, and setup steps when adding model features.
4. Confirm the install path when done.
HOW IT WORKS

Use seedream-v4-text-to-image with a model skill

01

Install

Install the model skill for this model line.

02

Configure

Set the model field to the full model ID shown on this page.

03

Call

Use the skill instructions while adding prompt, input, and callback handling to your app.

04

Receive

Read the task response, webhook callback, or cached output URL from RunAPI.

DIFFERENCES

What's different about seedream-v4-text-to-image

VS SEEDREAM-4.5-EDIT

Photorealistic 1K-4K batches; up to 6 images per prompt

Same realism with targeted region editing via mask/brush

VS SEEDREAM-4.5-TEXT-TO-IMAGE

Photorealistic 1K-4K batches; up to 6 images per prompt

Photorealistic output; stable anatomy; 8–14s generation

VS SEEDREAM-5-LITE-EDIT

Photorealistic 1K-4K batches; up to 6 images per prompt

Stronger reference adherence + bilingual typography vs 4.5; faster

USE CASES

Best for

Product photography

Auto-generate lifestyle product photos for e-commerce catalogs that lack studio photography.

Game & concept art

Rapidly concept environments and characters before committing to final art.

Editorial illustration

Generate unique cover art and illustrations for blog posts and articles at scale.

FAQ

Frequently asked questions about seedream-v4-text-to-image

Is the model ID stable across versions?

RunAPI keeps the model ID stable and handles compatible version refreshes without changing your request shape.

What's the rate limit on this variant?

Per-key rate limits scale with usage tier. See pricing page for current limits.

Can I switch variants later?

Yes — variant is a flag. Switch by changing the model parameter.

Does it stream?

Where streaming is available, RunAPI streams end-to-end.

Where do I report quality issues?

Open an issue on the public GitHub repo or email support.

START NOW

Start building with Seedream.