Seedream 5.0 Pro uses the model ID bytedance/seedream/v5.0/pro/edit. Edit and combine images with Seedream 5.0 Pro using a prompt and up to 10 reference images. Change subjects, colors or composition and generate one result at 1K, 1.5K or 2K.
1. Calling the API
Send requests to https://api.higgsfield.ai/bytedance/seedream/v5.0/pro/edit with a JSON body matching the parameters below.
Install
Install an official server-side SDK. cURL needs no package.
npm install @higgsfield/clientSetup
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 cURLRequest parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | — | Prompt. Minimum length: 1. |
image_urls | array[string] | Yes | — | Image URLs. |
resolution | string | No | "2k" | Resolution. Options: 1k, 1.5k, 2k. |
aspect_ratio | string | No | "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_KEY3. 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
Replace placeholder media URLs with accessible URLs for your own files.
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/edit",
{
input: {
"prompt": "Change the bottle in the reference image to emerald green, keeping the lighting and composition",
"image_urls": [
"https://example.com/reference.png"
],
"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 and 1–10 URLs in image_urls. Describe the intended edits and how each reference should be used. Choose resolution from 1k, 1.5k or 2k (default 2k); aspect_ratio defaults to 1:1. This endpoint produces one image and does not expose layer separation.
5. Pricing
| Resolution | Price 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.