Bytedance · Image

Hermes Agent x Seedream

Seedream is optimized for typography and style control. Through RunAPI, all Seedream variants share one key and unified billing.

9 variants from $0.08 / call Commercial OK
Get API Key View Hermes Agent Docs

Prerequisite: npx runapi mcp install

Prompt

Prompt models

Use seedream-4.5-edit when it matches the task: Same realism with targeted region editing via mask/brush.

You have access to RunAPI task tools for Seedream.

Available Seedream models:
- seedream-4.5-edit: Same realism with targeted region editing via mask/brush
  endpoints: /api/v1/seedream/edit_image
  request fields: model, prompt, aspect_ratio, output_quality, source_image_urls
- seedream-4.5-text-to-image: Photorealistic output; stable anatomy
  endpoints: /api/v1/seedream/text_to_image
  request fields: model, prompt, aspect_ratio, output_quality
- seedream-5-lite-edit: Stronger reference adherence + bilingual typography vs 4.5; faster
  endpoints: /api/v1/seedream/edit_image
  request fields: model, prompt, aspect_ratio, output_quality, source_image_urls
- seedream-5-lite-text-to-image: Real-time web search for time-sensitive prompts
  endpoints: /api/v1/seedream/text_to_image
  request fields: model, prompt, aspect_ratio, output_quality
- seedream-5-pro-edit: High-quality photorealistic editing for polished production imagery
  endpoints: /api/v1/seedream/edit_image
  request fields: model, prompt, aspect_ratio, output_quality, source_image_urls
- seedream-5-pro-layer-decomposition: Split one image into an editable base image and transparent PNG layers
  endpoints: /api/v1/seedream/decompose_layers
  request fields: model, image_url, size, output_format
- seedream-5-pro-text-to-image: High-quality photorealistic generation for polished production imagery
  endpoints: /api/v1/seedream/text_to_image
  request fields: model, prompt, aspect_ratio, output_quality
- seedream-v4-edit: Multi-image editing with up to 10 references and 4K output
  endpoints: /api/v1/seedream/edit_image
  request fields: model, prompt, aspect_ratio, output_quality, source_image_urls
- seedream-v4-text-to-image: Photorealistic 1K-4K batches; up to 6 images per prompt
  endpoints: /api/v1/seedream/text_to_image
  request fields: model, prompt, aspect_ratio, output_quality

Use the model ID and endpoint that match the user's request.
Example prompt: Create a social media graphic for a coffee shop sale with the text '50% OFF' in bold, warm tones, 4K.
/api/v1/seedream/edit_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/seedream/edit_image and save the returned Task id.
GET /api/v1/seedream/edit_image/<task-id> until status is completed or failed.
Verify the completed response contains the endpoint-specific output documented in the API reference.
/api/v1/seedream/text_to_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/seedream/text_to_image and save the returned Task id.
GET /api/v1/seedream/text_to_image/<task-id> until status is completed or failed.
Verify the completed response contains the endpoint-specific output documented in the API reference.
/api/v1/seedream/decompose_layers: Submit the task, poll for its status, then verify the completed output. POST /api/v1/seedream/decompose_layers and save the returned Task id.
GET /api/v1/seedream/decompose_layers/<task-id> until status is completed or failed.
Verify the completed response contains the endpoint-specific output documented in the API reference.

Public Versions and Endpoints

Model ID Endpoints Price Catalog
seedream-4.5-edit
/api/v1/seedream/edit_image
$0.10 / call Model detail
seedream-4.5-text-to-image
/api/v1/seedream/text_to_image
$0.10 / call Model detail
seedream-5-lite-edit
/api/v1/seedream/edit_image
$0.08 / call Model detail
seedream-5-lite-text-to-image
/api/v1/seedream/text_to_image
$0.08 / call Model detail
seedream-5-pro-edit
/api/v1/seedream/edit_image
$0.17 / call Model detail
seedream-5-pro-layer-decomposition
/api/v1/seedream/decompose_layers
$0.14 / call Model detail
seedream-5-pro-text-to-image
/api/v1/seedream/text_to_image
$0.11 / call Model detail
seedream-v4-edit
/api/v1/seedream/edit_image
$0.08 / call Model detail
seedream-v4-text-to-image
/api/v1/seedream/text_to_image
$0.08 / call Model detail

Verify

Poll until the task reaches a terminal status

Select <model-id> to generate verification commands.

Configuration

Guide endpoint: <endpoint>

Select <model-id> to generate a request with the endpoint's public input contract.
How it works

Get Started in 3 Steps

  1. Choose a model ID

    Select a public catalog model ID and review its endpoint and current starting price.

  2. Configure RunAPI

    Set RUNAPI_API_KEY before making the endpoint request.

  3. Verify the result

    For asynchronous endpoints, poll the same endpoint until the Task reaches a terminal status.

What to Build with Hermes Agent + Seedream

  • Social media marketing campaigns

    Generate consistent brand ambassador images across a campaign, keeping the same character appearance and brand identity across many outputs.

  • Book covers and packaging design

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

  • Brand identity development

    Explore several visual directions for a brand, with Seedream's prompt adherence keeping each variation true to the brief.

Why Use Seedream Through RunAPI + Hermes Agent

  • 9 variants, one API key

    Use one RunAPI connection to choose among the live model variants without changing your integration.

  • Clear usage pricing

    See current catalog pricing before you send a request, with no subscription or minimum spend required.

  • Automatic task workflows

    Submit, poll, and collect asynchronous results through a consistent task workflow without writing manual polling code.

Hermes Agent + Seedream Questions

Can I use Seedream in Hermes Agent?

Yes. Configure RunAPI as a provider in Hermes Agent, then call the Seedream endpoint shown on this page. The same API key handles chat and image generation.

Can Hermes Agent use Seedream in a multi-step design pipeline?

Yes. Hermes Agent can generate with Seedream, pass the output to an editing model for targeted changes, and finish with an upscaling model in one workflow.

Can Seedream keep a character consistent across a batch?

Yes. Describe the character in detail in each prompt and Seedream keeps facial features, proportions, and styling consistent across outputs.

Which model ID should I use?

Choose a public model ID from the version table. Each ID exposes the endpoints shown for that version.

Does this guide configure a chat model?

No. This Model Line uses the endpoint workflow shown here and is not presented as an agent chat model.

Start using Seedream with Hermes Agent

Get API Key Read Quickstart

Building with a team?

We're here to help with enterprise setup, integrations, and technical questions.

Contact Us