How to Use DDColor in opencode
DDColor adds plausible color to black-and-white photographs, including archival portraits and street scenes. It estimates colors from the image, so treat the result as an interpretation rather than a record of the original colors.
Prompts to try with DDColor in opencode
Copy an example into opencode, or ask in your own words.
Use DDColor to colorize the black-and-white portraits in this project's assets directory. Save separate results and create a contact sheet pairing each result with its original.
Use DDColor on the archival street photographs in this project. Build a review page that shows each original beside its colorized result and labels the colors as estimates.
Use DDColor to colorize one sample photograph from each archive subfolder. Create a review gallery before processing the remaining photographs.
Use DDColor on the project's monochrome photographs containing glassware. Put the originals and results side by side so I can inspect transparent objects for color artifacts.
Use DDColor to prepare color interpretations of the historical portraits in this repository. Add a review checklist for clothing colors that need independent historical verification.
How to set up DDColor in opencode
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Leave out --global to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
- Sign in
Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, /mcps starts the same sign-in.
opencode mcp auth spiral
- Check it
Spiral shows as connected.
opencode mcp list
Use the Spiral skill
- Send opencode 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 DDColor
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/ddcolor", "input": { "image_url": "https://storage.googleapis.com/falserverless/gallery/Screenshot%202025-02-26%20154226.png" } }'
Then paste one of the prompts above: opencode finds DDColor on Spiral, shows the price and runs it.
DDColor providers and prices
Spiral runs DDColor through fal. Open a card for today's price, with every fee included.
Settings you can ask for
DDColor works from your image URL. Ask opencode for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Seed | a whole number | seed to be used for generation |
Every API field of DDColor is on its tool page: open its card above.
What can you do with DDColor in opencode?
Turn a project's black-and-white photo collection into colorized review images. Have the coding agent preserve originals, pair each result with its source, and build a comparison view.
Personal photo albums
Create color interpretations of scanned black-and-white portraits for an album. Keep the original beside each result.
Local history articles
Colorize archival street photographs for an article, and label the results as AI colorizations.
Exhibition comparisons
Prepare original-and-colorized pairs for an exhibit about photographic interpretation. Let visitors compare the estimated colors with the source.
Classroom discussion materials
Colorize historical photographs for a lesson about visual evidence. Ask students which colors would require independent verification.
Documentary stills
Prepare colorized archival stills for editorial review. Check important clothing and object colors against historical references before publication.
Modern monochrome photo experiments
Try color interpretations of modern black-and-white photographs. Compare the results with the monochrome versions before choosing an editorial treatment.
More on DDColor and opencode
Overview
DDColor in other agents
More opencode guides
Questions about DDColor in opencode
Can opencode use DDColor?
Yes. Add Spiral to opencode as an MCP server, and opencode can find and run DDColor like any built-in tool.
How much does DDColor cost in opencode?
$0.0013 per 1,048,576 megapixels. Minimum 1,048,576 pixels. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.
Do I need a fal account to use DDColor in opencode?
No. Spiral runs DDColor on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up DDColor in opencode?
About two minutes: add the server, then sign in, then check it.
Does opencode wait while DDColor runs?
DDColor runs in the background. opencode starts the run, checks on it and gives you the image when it's ready.
What is DDColor useful for?
DDColor adds color to black-and-white photographs. Consider it for archival portraits, historical street scenes, or modern monochrome photos when you want a color interpretation.
Does DDColor recover historically accurate colors?
The result is a plausible estimate. A grayscale object can have several possible colors, so verify clothing, uniforms, and other historically important details against separate references.
Which images need extra review?
Check photographs containing transparent or translucent objects, such as glassware. The authors identify these objects as a source of color artifacts.
Is DDColor limited to 512 × 512 output?
The official implementation defaults to processing a 512 × 512 copy, then resizes the predicted color channels to the source dimensions. That does not establish a maximum output size for the hosted model.
How should I prompt an agent using DDColor?
Specify the photograph to colorize and what to inspect afterward, such as glass artifacts or colors that need historical verification. The official demo uses an image-driven workflow, so detailed prose about a desired palette is not established color control.
Start using DDColor in opencode
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into opencode:
set up https://spiral.ai/SKILL.md


