How to Use Seedream 4.0 Text to Image in Claude Code
Use Seedream 4.0 Text to Image for posters, illustrations, and coordinated image sets described in words. Choose it over Edit when you are creating the scene from a written brief.
Prompts to try with Seedream 4.0 Text to Image in Claude Code
Copy an example into Claude Code, or ask in your own words.
Read the project's homepage brief and use Seedream 4.0 Text to Image to create a 2048 × 2048 editorial illustration for it. Name the central subject, setting, palette, and lighting in the prompt. Leave the upper third clear for the page headline.
Read docs/onboarding.md and use Seedream 4.0 Text to Image to create a set of three 2048 × 2048 onboarding illustrations. Use the same small orange robot and ink illustration style throughout, with one scene for each onboarding step.
Read the event brief in docs/event.md and use Seedream 4.0 Text to Image to create a 2048 × 3072 poster concept. Put the event's exact title in double quotation marks in the image prompt and place it above the main illustration.
Generate a product photo with Seedream 4.0 Text to Image: a matte black water bottle on wet slate, soft morning light, 1:1. Tell me the price first. Save the result in ./assets.
Make four logo concepts for a coffee brand called "Northline" with Seedream 4.0 Text to Image.
How to set up Seedream 4.0 Text to Image in Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
This adds Spiral to the current project. Add --scope user to use it in every project.
claude mcp add --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.
Use the Spiral skill
- Send Claude Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Seedream 4.0 Text to Image
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "fal", "model": "fal-ai/bytedance/seedream/v4/text-to-image", "input": { "prompt": "A trendy restaurant with a digital menu board displaying \"Seedream 4.0 is available on fal\" in elegant script, with diners enjoying their meals." } }'
Then paste one of the prompts above: Claude Code finds Seedream 4.0 Text to Image on Spiral, shows the price and runs it.
Seedream 4.0 Text to Image providers and prices
Spiral runs Seedream 4.0 Text to Image through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Seedream 4.0 Text to Image works from your prompt. Ask Claude Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Number of images | 1 to 6 | 1 | Number of separate model generations to be run with the prompt. |
| Max images | 1 to 6 | 1 | If set to a number greater than one, enables multi-image generation. The model will potentially return up to |
| Seed | a whole number | Random seed to control the stochasticity of image generation. | |
| Enhance prompt mode | standard or fast | standard | The mode to use for enhancing prompt enhancement. Standard mode provides higher quality results but takes longer to generate. Fast mode provides average quality results but takes less time to generate. |
Every API field of Bytedance Seedream V4 · Text to Image is on its tool page: open its card above.
What can you do with Seedream 4.0 Text to Image in Claude Code?
Create visual assets from project briefs or revise images already in the repository. Use the agent to turn written requirements into specific compositions and coordinated image sets.
Storyboard a short scene
Request four related images with one character and one visual style. Describe each scene separately: arrival, discovery, decision, and departure.
Develop a poster concept
Specify the poster's purpose, subject, layout, and exact headline. Use a 2048 × 2048 square for a first composition or request a larger image when the design needs more space.
Revise an existing visual
Use Edit with a supplied image and a concrete instruction, such as replacing a background or changing an object's color. Name the target object directly.
Create a coordinated illustration set
Describe a shared palette, medium, and recurring subject, then request a small series. Give each image a distinct scene while repeating the visual requirements.
Combine visual references
Supply references for a character, setting, or style and explain the intended result. State which visual elements each reference contributes.
Explore a new composition from text
Start with a written brief for an illustration or poster. Specify the subject's position, the environment, and the direction of light.
More on Seedream 4.0 Text to Image and Claude Code
Overview
Seedream 4.0 Text to Image in other agents
Questions about Seedream 4.0 Text to Image in Claude Code
Can Claude Code use Seedream 4.0 Text to Image?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Seedream 4.0 Text to Image like any built-in tool.
How much does Seedream 4.0 Text to Image cost in Claude Code?
$0.039 per image. Billed on `num_images`, default 1. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.
Do I need a fal account to use Seedream 4.0 Text to Image in Claude Code?
No. Spiral runs Seedream 4.0 Text to Image on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Seedream 4.0 Text to Image in Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while Seedream 4.0 Text to Image runs?
Seedream 4.0 Text to Image runs in the background. Claude Code starts the run, checks on it and gives you the image when it's ready.
When should I choose Edit instead of Text to Image?
Choose Edit when you have a source image or visual references to follow. Choose Text to Image when your starting point is a written description; both use Seedream 4.0's shared generation and editing architecture.
How large can Seedream 4.0 images be?
The model supports up to 4K, including a 4096 × 4096 square. Custom dimensions must satisfy both the total pixel limit and the aspect ratio limit.
Can it create a matching series of images?
Yes. Related image sequences are a documented use for storyboards, comics, and coordinated designs. Describe the shared character and style, then specify what changes in each image.
How should I request text inside an image?
Put the exact wording in double quotation marks and state its role, such as the poster title or product label. For example, request a poster with the title "Weekend pottery".
Do longer prompts produce better results?
Very long prompts can cause the model to overlook details. BytePlus recommends staying under 600 English words; start with the subject, action, and setting, then add the visual requirements that matter.
Start using Seedream 4.0 Text to Image in Claude Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude Code:
set up https://spiral.ai/SKILL.md


