Explore/Seedream 5.0 Pro
Image

Seedream 5.0 Pro

Create images from detailed prompts with Seedream 5.0 Pro. Generate product visuals, posters and illustrations at 1K, 1.5K or 2K, with control over the aspect ratio.

View docs
import { config, higgsfield } from "@higgsfield/client/v2";config({  credentials: process.env.HF_CREDENTIALS,});const result = await higgsfield.subscribe(  "bytedance/seedream/v5.0/pro/text-to-image",  {    input: {      "prompt": "A cinematic scene at sunset",      "resolution": "2k",      "aspect_ratio": "1:1"    },    withPolling: true,  },);console.log(result);

Seedream 5.0 Pro uses the model ID bytedance/seedream/v5.0/pro/text-to-image. Create images from detailed prompts with Seedream 5.0 Pro. Generate product visuals, posters and illustrations at 1K, 1.5K or 2K, with control over the aspect ratio.

1. Calling the API

Send requests to https://api.higgsfield.ai/bytedance/seedream/v5.0/pro/text-to-image with a JSON body matching the parameters below.

Install

Install an official server-side SDK. cURL needs no package.

npm install @higgsfield/client

Setup

Keep credentials in server-side environment variables. The SDKs accept the same KEY_ID:KEY_SECRET value under their documented variable names.

export HF_CREDENTIALS="YOUR_KEY_ID:YOUR_KEY_SECRET" # TypeScript export HF_KEY="YOUR_KEY_ID:YOUR_KEY_SECRET" # Python and cURL

Request parameters

ParameterTypeRequiredDefaultDescription
promptstringYes—Prompt. Minimum length: 1.
resolutionstringNo"2k"Resolution. Options: 1k, 1.5k, 2k.
aspect_ratiostringNo"1:1"Aspect Ratio. Options: auto, 1:1, 4:3, 16:9, 3:2, 21:9, 3:4, 9:16, 2:3.

2. Authentication

The official SDKs read credentials from the server environment and send the required Authorization: Key KEY_ID:KEY_SECRET header.

API Key

Never expose the secret in browser-side code or commit it to source control. The TypeScript SDK is server-side only. For direct HTTP calls, use:

Authorization: Key $HF_KEY

3. Queue

subscribe submits the asynchronous request and waits for a terminal result. The TypeScript SDK polls automatically when withPolling: true; the Python SDK's synchronous subscribe call also waits. A completed request returns generated files in the images array.

Submit and wait

import { config, higgsfield } from "@higgsfield/client/v2"; config({ credentials: process.env.HF_CREDENTIALS, baseURL: "https://api.higgsfield.ai", }); const result = await higgsfield.subscribe( "bytedance/seedream/v5.0/pro/text-to-image", { input: { "prompt": "A studio product photograph of a green glass perfume bottle on pale stone, soft morning light", "resolution": "2k", "aspect_ratio": "1:1" }, withPolling: true, }, ); console.log(result);

Custom polling

For direct HTTP integration, submit the request and poll the returned status_url using the same API credentials until it reaches a terminal status. Use the returned cancel_url to request cancellation while the request is still queued. See the request lifecycle guide for response states.

4. Using this model

Provide a non-empty prompt. Choose resolution from 1k, 1.5k or 2k (default 2k) and an aspect_ratio (default 1:1). This endpoint returns one image; use the Image Edit variant to supply reference images.

5. Pricing

ResolutionPrice per image
1k$0.054
1.5k$0.054
2k$0.108

Each request generates one image. Reference images do not add a separate charge. The default 2k request costs $0.108.