HERMES + SEEDREAM

Use Seedream in Hermes Agent.

Seedream is Bytedance's image generation model with strong typography rendering and up to 4K output. Hermes Agent calls it through the same RunAPI custom provider and API key used for chat — no extra plugins or GPU rentals.

one API key · text to image endpoint · async task polling
Generate a 4K product hero image using Seedream through RunAPI.

Requirements:
- Use the RunAPI text_to_image endpoint via the custom:runapi provider.
- Set model to seedream-4.5-text-to-image.
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Poll the task status endpoint until the task completes.
- Return the generated image URL from the task response.
curl -X POST https://runapi.ai/api/v1/task/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-4.5-text-to-image",
    "prompt": "A premium coffee bag on a marble countertop, warm morning light, bold serif text FRESH ROAST, 4K product photography"
  }'
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "seedream-4.5-text-to-image"
}
Copy the curl command to test seedream
HOW IT WORKS

Use Seedream in Hermes Agent in three steps

1

Configure RunAPI

If you already set up RunAPI in Hermes Agent for chat, you are done. The same custom:runapi provider and RUNAPI_API_KEY handle image generation. If not, add the custom provider with base_url https://runapi.ai/v1 and run hermes doctor.

export RUNAPI_API_KEY=runapi_xxx
2

Call Seedream

Send a request to the text_to_image endpoint with model set to seedream-4.5-text-to-image. Include a text prompt describing the image. RunAPI returns a task ID immediately.

text_to_image
3

Get the result

Poll the task status endpoint with the returned task ID. When the status changes to completed, the response includes the generated image URL. RunAPI SDKs handle polling automatically.

task_id: tsk_abc123
PARAMETERS

Seedream API parameters

Parameter Type Description
model string Required. seedream-4.5-text-to-image, seedream-4.5-edit, seedream-5-lite-text-to-image.
prompt string Text description of the desired image.
size string Optional. Output dimensions. Supports up to 4K.
image_url string Source image for editing mode.

What is Seedream on Hermes Agent?

Seedream by ByteDance is the LM Arena leaderboard-topping image model known for professional-grade output that reviewers call a "huge leap in fidelity." It understands complex prompt structures and delivers out-of-the-box results for both photorealistic and stylized content, with particular strength in maintaining a consistent house style across batch generation. Hermes Agent calls it through the RunAPI custom provider.

Seedream use cases

Social media marketing campaigns

Generate consistent brand ambassador images across an entire campaign, with the model maintaining the same character appearance and brand identity across dozens of outputs.

Book covers and packaging design

Create book covers, product packaging, and label designs with accurate text rendering and precise layout control at 4K resolution.

Brand identity development

Explore multiple visual directions for brand identity -- logos, color schemes, and product mockups -- with Seedream's strong prompt adherence keeping each variation true to the brief.

FAQ

Seedream + Hermes Agent questions

Hermes Agent general setup

Not configured yet? Start with the RunAPI setup guide for Hermes Agent.

Hermes Agent setup guide →

Seedream model catalog

See all Seedream variants, pricing, and API docs.

Seedream models →

Try Seedream in Hermes Agent today.

Get a free RunAPI key, configure the custom provider, and start generating 4K images with Seedream.