Skip to content

Commit 3a88d4a

Browse files
techpro-aimlapigitbook-bot
authored andcommitted
GITBOOK-399: docs: add seedream v4 and v4 edit
1 parent 518cd57 commit 3a88d4a

10 files changed

Lines changed: 264 additions & 6 deletions
3.13 MB
Loading
1010 KB
Loading

‎docs/SUMMARY.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -118,6 +118,8 @@
118118
* [ByteDance](api-references/image-models/bytedance/README.md)
119119
* [Seedream 3.0](api-references/image-models/bytedance/seedream-3.0.md)
120120
* [Seededit 3.0 (Image-to-Image)](api-references/image-models/bytedance/seededit-3.0-image-to-image.md)
121+
* [Seedream v4 (Text-to-Image)](api-references/image-models/bytedance/seedream-v4-text-to-image.md)
122+
* [Seedream v4 Edit (Image-to-image)](api-references/image-models/bytedance/seedream-v4-edit-image-to-image.md)
121123
* [Flux](api-references/image-models/flux/README.md)
122124
* [flux-pro](api-references/image-models/flux/flux-pro.md)
123125
* [flux-pro/v1.1](api-references/image-models/flux/flux-pro-v1.1.md)

‎docs/api-references/image-models/README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -64,4 +64,4 @@ We obtained the following image by running that code example:
6464

6565
## All Available Image Models
6666

67-
<table><thead><tr><th width="274.20001220703125">Model ID + API Reference link</th><th width="123.39996337890625">Developer</th><th width="103.79998779296875">Context</th><th>Model Card</th></tr></thead><tbody><tr><td><a href="alibaba-cloud/qwen-image.md">alibaba/qwen-image</a></td><td>Alibaba Cloud</td><td></td><td><a href="https://aimlapi.com/models/qwen-image">Qwen Image</a></td></tr><tr><td><a href="alibaba-cloud/qwen-image-edit.md">alibaba/qwen-image-edit</a></td><td>Alibaba Cloud</td><td></td><td><em>Coming Soon</em></td></tr><tr><td><a href="bytedance/seedream-3.0.md">bytedance/seedream-3.0</a></td><td>ByteDance</td><td></td><td><a href="https://aimlapi.com/models/seedream-3-0">Seedream 3.0</a></td></tr><tr><td><a href="bytedance/seededit-3.0-image-to-image.md">bytedance/seededit-3.0-i2i</a></td><td>ByteDance</td><td></td><td><a href="https://aimlapi.com/models/seedream-3-0">Seedream 3.0</a></td></tr><tr><td><a href="flux/flux-pro.md">flux-pro</a></td><td>Flux</td><td></td><td><a href="https://aimlapi.com/models/flux-1-pro-api">FLUX.1 [pro]</a></td></tr><tr><td><a href="flux/flux-pro.md">flux-pro/v1.1</a></td><td>Flux</td><td></td><td><a href="https://aimlapi.com/models/flux-1-1-pro-api">FLUX 1.1 [pro]</a></td></tr><tr><td><a href="flux/flux-pro-v1.1-ultra.md">flux-pro/v1.1-ultra</a></td><td>Flux</td><td></td><td><a href="https://aimlapi.com/models/flux-1-1-pro-ultra-api">FLUX 1.1 [pro ultra]</a></td></tr><tr><td><a href="flux/flux-realism.md">flux-realism</a></td><td>Flux</td><td></td><td><a href="https://aimlapi.com/models/flux-realism-lora-api">FLUX Realism LoRA</a></td></tr><tr><td><a href="flux/flux-dev.md">flux/dev</a></td><td>Flux</td><td></td><td><a href="https://aimlapi.com/models/flux-1-dev-api">FLUX.1 [dev]</a></td></tr><tr><td><a href="flux/flux-dev-image-to-image.md">flux/dev/image-to-image</a></td><td>Flux</td><td></td><td>-</td></tr><tr><td><a href="flux/flux-schnell.md">flux/schnell</a></td><td>Flux</td><td></td><td><a href="https://aimlapi.com/models/flux-1-schnell-api">FLUX.1 [schnell]</a></td></tr><tr><td><a href="flux/flux-kontext-max-text-to-image.md">flux/kontext-max/text-to-image</a></td><td>Flux</td><td></td><td><a href="https://aimlapi.com/models/flux-1-kontext-max">FLUX.1 Kontext [max]</a></td></tr><tr><td><a href="flux/flux-kontext-max-image-to-image.md">flux/kontext-max/image-to-image</a></td><td>Flux</td><td></td><td><a href="https://aimlapi.com/models/flux-1-kontext-max">FLUX.1 Kontext [max]</a></td></tr><tr><td><a href="flux/flux-kontext-pro-text-to-image.md">flux/kontext-pro/text-to-image</a></td><td>Flux</td><td></td><td><a href="https://aimlapi.com/models/flux-1-kontext-pro">Flux.1 Kontext [pro]</a></td></tr><tr><td><a href="flux/flux-kontext-pro-image-to-image.md">flux/kontext-pro/image-to-image</a></td><td>Flux</td><td></td><td><a href="https://aimlapi.com/models/flux-1-kontext-pro">Flux.1 Kontext [pro]</a></td></tr><tr><td><a href="google/imagen-3.0.md">imagen-3.0-generate-002</a></td><td>Google</td><td></td><td><a href="https://aimlapi.com/models/imagen-3-api">Imagen 3</a></td></tr><tr><td><a href="google/imagen-4-preview.md">google/imagen4/preview</a></td><td>Google</td><td></td><td><a href="https://aimlapi.com/models/imagen-4-preview">Imagen 4 Preview</a></td></tr><tr><td><a href="google/imagen-4-ultra.md">imagen-4.0-ultra-generate-preview-06-06</a></td><td>Google</td><td></td><td><a href="https://aimlapi.com/models/imagen-4-ultra">Imagen 4 Ultra</a></td></tr><tr><td><a href="google/gemini-2.5-flash-image.md">google/gemini-2.5-flash-image</a></td><td>Google</td><td></td><td><a href="https://aimlapi.com/models/gemini-2-5-flash-image">Gemini 2.5 Flash Image</a></td></tr><tr><td><a href="google/gemini-2.5-flash-image.md">google/gemini-2.5-flash-image-edit</a></td><td>Google</td><td></td><td><a href="https://aimlapi.com/models/gemini-2-5-flash-image-edit">Gemini 2.5 Flash Image Edit</a></td></tr><tr><td><a href="OpenAI/dall-e-2.md">dall-e-2</a></td><td>OpenAI</td><td></td><td><a href="https://aimlapi.com/models/openai-dall-e-2-api">OpenAI DALL·E 2</a></td></tr><tr><td><a href="OpenAI/dall-e-3.md">dall-e-3</a></td><td>OpenAI</td><td></td><td><a href="https://aimlapi.com/models/openai-dall-e-3">OpenAI DALL·E 3</a></td></tr><tr><td><a href="openai/gpt-image-1.md">openai/gpt-image-1</a></td><td>OpenAI</td><td></td><td><a href="https://aimlapi.com/models/gpt-image-1">gpt-image-1</a></td></tr><tr><td><a href="RecraftAI/recraft-v3.md">recraft-v3</a></td><td>Recraft AI</td><td></td><td><a href="https://aimlapi.com/models/recraft-v3">Recraft v3</a></td></tr><tr><td><a href="Stability-AI/stable-diffusion-v3-medium.md">stable-diffusion-v3-medium</a></td><td>Stability AI</td><td></td><td><a href="https://aimlapi.com/models/stable-diffusion-3-api">Stable Diffusion 3</a></td></tr><tr><td><a href="Stability-AI/stable-diffusion-v35-large.md">stable-diffusion-v35-large</a></td><td>Stability AI</td><td></td><td><a href="https://aimlapi.com/models/stable-diffusion-3-5-large-api">Stable Diffusion 3.5 Large</a></td></tr></tbody></table>
67+
<table><thead><tr><th width="274.20001220703125">Model ID + API Reference link</th><th width="123.39996337890625">Developer</th><th width="103.79998779296875">Context</th><th>Model Card</th></tr></thead><tbody><tr><td><a href="alibaba-cloud/qwen-image.md">alibaba/qwen-image</a></td><td>Alibaba Cloud</td><td></td><td><a href="https://aimlapi.com/models/qwen-image">Qwen Image</a></td></tr><tr><td><a href="alibaba-cloud/qwen-image-edit.md">alibaba/qwen-image-edit</a></td><td>Alibaba Cloud</td><td></td><td><em>Coming Soon</em></td></tr><tr><td><a href="bytedance/seedream-3.0.md">bytedance/seedream-3.0</a></td><td>ByteDance</td><td></td><td><a href="https://aimlapi.com/models/seedream-3-0">Seedream 3.0</a></td></tr><tr><td><a href="bytedance/seededit-3.0-image-to-image.md">bytedance/seededit-3.0-i2i</a></td><td>ByteDance</td><td></td><td><a href="https://aimlapi.com/models/seedream-3-0">Seedream 3.0</a></td></tr><tr><td><a href="bytedance/seedream-v4-text-to-image.md">bytedance/seedream-v4-text-to-image</a></td><td>ByteDance</td><td></td><td><em>Coming Soon</em></td></tr><tr><td><a href="bytedance/seedream-v4-edit-image-to-image.md">bytedance/seedream-v4-edit</a></td><td>ByteDance</td><td></td><td><em>Coming Soon</em></td></tr><tr><td><a href="flux/flux-pro.md">flux-pro</a></td><td>Flux</td><td></td><td><a href="https://aimlapi.com/models/flux-1-pro-api">FLUX.1 [pro]</a></td></tr><tr><td><a href="flux/flux-pro.md">flux-pro/v1.1</a></td><td>Flux</td><td></td><td><a href="https://aimlapi.com/models/flux-1-1-pro-api">FLUX 1.1 [pro]</a></td></tr><tr><td><a href="flux/flux-pro-v1.1-ultra.md">flux-pro/v1.1-ultra</a></td><td>Flux</td><td></td><td><a href="https://aimlapi.com/models/flux-1-1-pro-ultra-api">FLUX 1.1 [pro ultra]</a></td></tr><tr><td><a href="flux/flux-realism.md">flux-realism</a></td><td>Flux</td><td></td><td><a href="https://aimlapi.com/models/flux-realism-lora-api">FLUX Realism LoRA</a></td></tr><tr><td><a href="flux/flux-dev.md">flux/dev</a></td><td>Flux</td><td></td><td><a href="https://aimlapi.com/models/flux-1-dev-api">FLUX.1 [dev]</a></td></tr><tr><td><a href="flux/flux-dev-image-to-image.md">flux/dev/image-to-image</a></td><td>Flux</td><td></td><td>-</td></tr><tr><td><a href="flux/flux-schnell.md">flux/schnell</a></td><td>Flux</td><td></td><td><a href="https://aimlapi.com/models/flux-1-schnell-api">FLUX.1 [schnell]</a></td></tr><tr><td><a href="flux/flux-kontext-max-text-to-image.md">flux/kontext-max/text-to-image</a></td><td>Flux</td><td></td><td><a href="https://aimlapi.com/models/flux-1-kontext-max">FLUX.1 Kontext [max]</a></td></tr><tr><td><a href="flux/flux-kontext-max-image-to-image.md">flux/kontext-max/image-to-image</a></td><td>Flux</td><td></td><td><a href="https://aimlapi.com/models/flux-1-kontext-max">FLUX.1 Kontext [max]</a></td></tr><tr><td><a href="flux/flux-kontext-pro-text-to-image.md">flux/kontext-pro/text-to-image</a></td><td>Flux</td><td></td><td><a href="https://aimlapi.com/models/flux-1-kontext-pro">Flux.1 Kontext [pro]</a></td></tr><tr><td><a href="flux/flux-kontext-pro-image-to-image.md">flux/kontext-pro/image-to-image</a></td><td>Flux</td><td></td><td><a href="https://aimlapi.com/models/flux-1-kontext-pro">Flux.1 Kontext [pro]</a></td></tr><tr><td><a href="google/imagen-3.0.md">imagen-3.0-generate-002</a></td><td>Google</td><td></td><td><a href="https://aimlapi.com/models/imagen-3-api">Imagen 3</a></td></tr><tr><td><a href="google/imagen-4-preview.md">google/imagen4/preview</a></td><td>Google</td><td></td><td><a href="https://aimlapi.com/models/imagen-4-preview">Imagen 4 Preview</a></td></tr><tr><td><a href="google/imagen-4-ultra.md">imagen-4.0-ultra-generate-preview-06-06</a></td><td>Google</td><td></td><td><a href="https://aimlapi.com/models/imagen-4-ultra">Imagen 4 Ultra</a></td></tr><tr><td><a href="google/gemini-2.5-flash-image.md">google/gemini-2.5-flash-image</a></td><td>Google</td><td></td><td><a href="https://aimlapi.com/models/gemini-2-5-flash-image">Gemini 2.5 Flash Image</a></td></tr><tr><td><a href="google/gemini-2.5-flash-image.md">google/gemini-2.5-flash-image-edit</a></td><td>Google</td><td></td><td><a href="https://aimlapi.com/models/gemini-2-5-flash-image-edit">Gemini 2.5 Flash Image Edit</a></td></tr><tr><td><a href="OpenAI/dall-e-2.md">dall-e-2</a></td><td>OpenAI</td><td></td><td><a href="https://aimlapi.com/models/openai-dall-e-2-api">OpenAI DALL·E 2</a></td></tr><tr><td><a href="OpenAI/dall-e-3.md">dall-e-3</a></td><td>OpenAI</td><td></td><td><a href="https://aimlapi.com/models/openai-dall-e-3">OpenAI DALL·E 3</a></td></tr><tr><td><a href="openai/gpt-image-1.md">openai/gpt-image-1</a></td><td>OpenAI</td><td></td><td><a href="https://aimlapi.com/models/gpt-image-1">gpt-image-1</a></td></tr><tr><td><a href="RecraftAI/recraft-v3.md">recraft-v3</a></td><td>Recraft AI</td><td></td><td><a href="https://aimlapi.com/models/recraft-v3">Recraft v3</a></td></tr><tr><td><a href="Stability-AI/stable-diffusion-v3-medium.md">stable-diffusion-v3-medium</a></td><td>Stability AI</td><td></td><td><a href="https://aimlapi.com/models/stable-diffusion-3-api">Stable Diffusion 3</a></td></tr><tr><td><a href="Stability-AI/stable-diffusion-v35-large.md">stable-diffusion-v35-large</a></td><td>Stability AI</td><td></td><td><a href="https://aimlapi.com/models/stable-diffusion-3-5-large-api">Stable Diffusion 3.5 Large</a></td></tr></tbody></table>
Lines changed: 123 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,123 @@
1+
# Seedream v4 Edit (Image-to-image)
2+
3+
4+
5+
{% hint style="info" %}
6+
This documentation is valid for the following list of our models:
7+
8+
* `bytedance/seedream-v4-edit`
9+
{% endhint %}
10+
11+
## Model Overview
12+
13+
The model supports background replacement, object editing, style and color adjustments, lighting and texture enhancements, and artistic filters, while ensuring character consistency and allowing iterative refinement.
14+
15+
## Setup your API Key
16+
17+
If you don’t have an API key for the AI/ML API yet, feel free to use our [Quickstart guide](https://docs.aimlapi.com/quickstart/setting-up).
18+
19+
## API Schema
20+
21+
{% openapi-operation spec="seedream-v4-edit" path="/v1/images/generations" method="post" %}
22+
[OpenAPI seedream-v4-edit](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/image-models/ByteDance/seedream-v4-edit.json)
23+
{% endopenapi-operation %}
24+
25+
## Quick Example
26+
27+
Let's generate an image of the specified size using a simple prompt.
28+
29+
{% tabs %}
30+
{% tab title="Python" %}
31+
{% code overflow="wrap" %}
32+
```python
33+
import requests
34+
import json # for getting a structured output with indentation
35+
36+
response = requests.post(
37+
"https://api.aimlapi.com/v1/images/generations",
38+
headers={
39+
# Insert your AIML API Key instead of <YOUR_AIMLAPI_KEY>:
40+
"Authorization":"Bearer <YOUR_AIMLAPI_KEY>",
41+
"Content-Type":"application/json",
42+
},
43+
json={
44+
"model":"bytedance/seedream-v4-edit",
45+
"prompt": "Add a crown to the T-rex's head.",
46+
"image_urls": [
47+
"https://raw.githubusercontent.com/aimlapi/api-docs/main/reference-files/t-rex.png"
48+
]
49+
}
50+
)
51+
52+
data = response.json()
53+
print(json.dumps(data, indent=2, ensure_ascii=False))
54+
```
55+
{% endcode %}
56+
{% endtab %}
57+
58+
{% tab title="JS" %}
59+
{% code overflow="wrap" %}
60+
```javascript
61+
const response = await fetch('https://api.aimlapi.com/v1/images/generations', {
62+
method: 'POST',
63+
headers: {
64+
// Insert your AIML API Key instead of <YOUR_AIMLAPI_KEY>:
65+
'Authorization': 'Bearer <YOUR_AIMLAPI_KEY>',
66+
'Content-Type': 'application/json',
67+
},
68+
body: JSON.stringify({
69+
model: 'bytedance/seedream-v4-edit',
70+
prompt: 'Add a bird to the foreground of the photo.',
71+
image_urls: [
72+
'https://raw.githubusercontent.com/aimlapi/api-docs/main/reference-files/t-rex.png'
73+
],
74+
}),
75+
});
76+
77+
const data = await response.json();
78+
console.log(JSON.stringify(data, null, 2));
79+
```
80+
{% endcode %}
81+
{% endtab %}
82+
{% endtabs %}
83+
84+
<details>
85+
86+
<summary>Response</summary>
87+
88+
{% code overflow="wrap" %}
89+
```json5
90+
{
91+
"images": [
92+
{
93+
"url": "https://v3b.fal.media/files/b/kangaroo/nHWHZmeMr-SL4R7uFtvq7_d54b8823cf784f67bcfa43993bdb2179.png",
94+
"content_type": "image/png",
95+
"file_name": "d54b8823cf784f67bcfa43993bdb2179.png",
96+
"file_size": 1033237,
97+
"width": null,
98+
"height": null
99+
}
100+
],
101+
"seed": 623004765,
102+
"data": [
103+
{
104+
"url": "https://v3b.fal.media/files/b/kangaroo/nHWHZmeMr-SL4R7uFtvq7_d54b8823cf784f67bcfa43993bdb2179.png",
105+
"content_type": "image/png",
106+
"file_name": "d54b8823cf784f67bcfa43993bdb2179.png",
107+
"file_size": 1033237,
108+
"width": null,
109+
"height": null
110+
}
111+
],
112+
"meta": {
113+
"usage": {
114+
"tokens_used": 63000
115+
}
116+
}
117+
}
118+
```
119+
{% endcode %}
120+
121+
</details>
122+
123+
<table data-full-width="false"><thead><tr><th>Reference Image</th><th>Generated Image</th></tr></thead><tbody><tr><td><div><figure><img src="../../../.gitbook/assets/flux-dev-t-rex.png" alt=""><figcaption><p>(original)</p></figcaption></figure></div></td><td><div><figure><img src="../../../.gitbook/assets/nHWHZmeMr-SL4R7uFtvq7_d54b8823cf784f67bcfa43993bdb2179.jpg" alt=""><figcaption><p><code>"Add a bird to the foreground of the photo."</code></p></figcaption></figure></div></td></tr></tbody></table>
Lines changed: 133 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,133 @@
1+
# Seedream v4 (Text-to-Image)
2+
3+
{% hint style="info" %}
4+
This documentation is valid for the following list of our models:
5+
6+
* `bytedance/seedream-v4-text-to-image`
7+
{% endhint %}
8+
9+
## Model Overview
10+
11+
Ultra-fast, consistent in character rendering, and matching [Gemini 2.5 Flash Image (Nano Banana)](../google/gemini-2.5-flash-image.md) in quality.
12+
13+
## Setup your API Key
14+
15+
If you don’t have an API key for the AI/ML API yet, feel free to use our [Quickstart guide](https://docs.aimlapi.com/quickstart/setting-up).
16+
17+
## API Schema
18+
19+
{% openapi-operation spec="seedream-v4-text-to-image" path="/v1/images/generations" method="post" %}
20+
[OpenAPI seedream-v4-text-to-image](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/image-models/ByteDance/seedream-v4-text-to-image.json)
21+
{% endopenapi-operation %}
22+
23+
## Quick Example
24+
25+
Let's generate an image of the specified size using a simple prompt.
26+
27+
{% tabs %}
28+
{% tab title="Python" %}
29+
{% code overflow="wrap" %}
30+
```python
31+
import requests
32+
import json # for getting a structured output with indentation
33+
34+
def main():
35+
response = requests.post(
36+
"https://api.aimlapi.com/v1/images/generations",
37+
headers={
38+
# Insert your AIML API Key instead of <YOUR_AIMLAPI_KEY>:
39+
"Authorization": "Bearer <YOUR_AIMLAPI_KEY>",
40+
"Content-Type": "application/json",
41+
},
42+
json={
43+
"model": "bytedance/seedream-v4-text-to-image",
44+
"prompt": "A T-Rex relaxing on a beach, lying on a sun lounger and wearing sunglasses.",
45+
"image_size": {
46+
"width": 4096,
47+
"height": 4096
48+
},
49+
}
50+
)
51+
52+
data = response.json()
53+
print(json.dumps(data, indent=2, ensure_ascii=False))
54+
55+
if __name__ == "__main__":
56+
main()
57+
```
58+
{% endcode %}
59+
{% endtab %}
60+
61+
{% tab title="JS" %}
62+
{% code overflow="wrap" %}
63+
```javascript
64+
async function main() {
65+
const response = await fetch('https://api.aimlapi.com/v1/images/generations', {
66+
method: 'POST',
67+
headers: {
68+
// Insert your AIML API Key instead of <YOUR_AIMLAPI_KEY>:
69+
'Authorization': 'Bearer <YOUR_AIMLAPI_KEY>',
70+
'Content-Type': 'application/json',
71+
},
72+
body: JSON.stringify({
73+
model: 'bytedance/seedream-3.0',
74+
prompt: 'A T-Rex relaxing on a beach, lying on a sun lounger and wearing sunglasses.',
75+
image_size: {
76+
width: 4096,
77+
height: 4096
78+
},
79+
}),
80+
});
81+
82+
const data = await response.json();
83+
console.log('Generation:', data);
84+
}
85+
86+
main();
87+
```
88+
{% endcode %}
89+
{% endtab %}
90+
{% endtabs %}
91+
92+
<details>
93+
94+
<summary>Response</summary>
95+
96+
{% code overflow="wrap" %}
97+
```json5
98+
{
99+
"images": [
100+
{
101+
"url": "https://v3b.fal.media/files/b/lion/O0byJzpkMBsjWFUMSRelX_ae55fef23aa54a1cad92c3abdf8f5337.png",
102+
"content_type": "image/png",
103+
"file_name": "ae55fef23aa54a1cad92c3abdf8f5337.png",
104+
"file_size": 3282232,
105+
"width": null,
106+
"height": null
107+
}
108+
],
109+
"seed": 1367947822,
110+
"data": [
111+
{
112+
"url": "https://v3b.fal.media/files/b/lion/O0byJzpkMBsjWFUMSRelX_ae55fef23aa54a1cad92c3abdf8f5337.png",
113+
"content_type": "image/png",
114+
"file_name": "ae55fef23aa54a1cad92c3abdf8f5337.png",
115+
"file_size": 3282232,
116+
"width": null,
117+
"height": null
118+
}
119+
],
120+
"meta": {
121+
"usage": {
122+
"tokens_used": 63000
123+
}
124+
}
125+
}
126+
```
127+
{% endcode %}
128+
129+
</details>
130+
131+
We obtained the following 4096x4096 image by running this code example:
132+
133+
<figure><img src="../../../.gitbook/assets/bytedance-seedream-v4-text-to-image_output.jpg" alt=""><figcaption><p><code>"A T-Rex relaxing on a beach, lying on a sun lounger and wearing sunglasses."</code></p></figcaption></figure>

0 commit comments

Comments
 (0)