Flux 2.0 이미지 생성
Generate high-quality images using Flux 2.0 model, supporting text-to-image and image-to-image
중국 본토 사용자 안내: 중국 본토 사용자는 https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.
- Flux 2.0 image generation model
- Choose
flux-2-flex(faster, for quick iteration) orflux-2-pro(higher quality, better details) via the model parameter - Supports text-to-image and image-to-image, up to 8 reference images
- Billed by resolution (1K/2K)
- Async task mode, returns
task_idfor querying results
Important Change: For better performance and cost control, we no longer support passing base64 image data directly in image_urls. Please use the Upload 이미지 API first to upload images and get URLs, then call this endpoint.
Authorization
Authorizationstring헤더필수All endpoints require Bearer Token authentication
Get your API Key: Visit the API Key Management Page to get your API Key
Add to request header:
Authorization: Bearer YOUR_API_KEY요청 파라미터
modelstring본문필수Image generation model name
Options:
flux-2-flex- Faster, suitable for quick iterationflux-2-pro- Higher quality, better details
promptstring본문필수Text description for image generation
sizestring본문기본값: 1:1Image aspect ratio
Supported aspect ratios:
1:1- Square (default)4:3/3:4- Traditional display ratio16:9/9:16- Widescreen/portrait3:2/2:3- Standard photo
image_urlsstring[]본문Reference image URL array for image-to-image
⚠️ URL format only (base64 not supported)
- Publicly accessible image URL (http:// or https://)
- Use the Upload 이미지 API to upload local images and get URLs
Limits:
- Maximum 8 reference images
metadataobject본문Metadata parameters for additional configuration options
Supported metadata fields
resolutionstring본문기본값: 1KOutput image resolution
Options:
1K- Standard resolution (default)2K- High resolution
Resolution vs. aspect ratio pixel dimensions:
| Aspect Ratio | 1K Size | 2K Size |
|---|---|---|
| 1:1 | 1024×1024 | 2048×2048 |
| 4:3 | 1365×1024 | 2730×2048 |
| 3:4 | 1024×1365 | 2048×2730 |
| 16:9 | 1820×1024 | 3640×2048 |
| 9:16 | 1024×1820 | 2048×3640 |
| 3:2 | 1536×1024 | 3072×2048 |
| 2:3 | 1024×1536 | 2048×3072 |
Note: Different resolutions have different billing; 2K costs more than 1K.
응답
idstringUnique task identifier for querying task status
objectstringObject type, fixed as generation.task
modelstring모델 name used for generation
statusstringTask status
queued- Waiting to be processedin_progress- Processingcompleted- Successfully completedfailed- Failed
progressintegerTask progress percentage (0-100)
created_atintegerTask creation timestamp (Unix timestamp)
metadataobjectTask metadata
Use Cases
Case 1: Text-to-Image (Quick Iteration)
{
"model": "flux-2-flex",
"prompt": "A cute orange cat sunbathing on a windowsill",
"size": "1:1",
"metadata": {
"resolution": "1K"
}
}Case 2: Text-to-Image (High Quality Output)
{
"model": "flux-2-pro",
"prompt": "Future city skyline, neon lights, cyberpunk style, cinematic quality",
"size": "16:9",
"metadata": {
"resolution": "2K"
}
}Case 3: Image-to-Image (Multiple Reference Images)
{
"model": "flux-2-pro",
"prompt": "Keep character style, generate a scene of running in the forest",
"size": "1:1",
"image_urls": [
"https://example.com/ref1.jpg",
"https://example.com/ref2.jpg"
],
"metadata": {
"resolution": "2K"
}
}Case 4: Portrait Poster
{
"model": "flux-2-flex",
"prompt": "Concert poster, minimalist style, dark background",
"size": "9:16",
"metadata": {
"resolution": "1K"
}
}Query Task Results
Image generation is an async task. After submission, a task ID is returned. Use the Get Image Task 상태 endpoint to query generation progress and results.
요청 예시
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "flux-2-flex",
"prompt": "A cute orange cat sunbathing on a windowsill",
"size": "1:1",
"metadata": {
"resolution": "1K"
}
}'curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "flux-2-pro",
"prompt": "Keep character style, generate a scene of running in the forest",
"size": "1:1",
"image_urls": ["https://example.com/ref1.jpg"],
"metadata": {
"resolution": "2K"
}
}'import requests
response = requests.post(
"https://toapis.com/v1/images/generations",
headers={
"Authorization": "Bearer your-ToAPIs-key",
"Content-Type": "application/json"
},
json={
"model": "flux-2-flex",
"prompt": "A cute orange cat sunbathing on a windowsill",
"size": "1:1",
"metadata": {
"resolution": "1K"
}
}
)
task = response.json()
print(f"Task ID: {task['id']}")
print(f"Status: {task['status']}")import requests
response = requests.post(
"https://toapis.com/v1/images/generations",
headers={
"Authorization": "Bearer your-ToAPIs-key",
"Content-Type": "application/json"
},
json={
"model": "flux-2-pro",
"prompt": "Keep character style, generate a scene of running in the forest",
"size": "1:1",
"image_urls": ["https://example.com/ref1.jpg"],
"metadata": {
"resolution": "2K"
}
}
)
task = response.json()
print(f"Task ID: {task['id']}")
print(f"Status: {task['status']}")const response = await fetch('https://toapis.com/v1/images/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-ToAPIs-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'flux-2-flex',
prompt: 'A cute orange cat sunbathing on a windowsill',
size: '1:1',
metadata: {
resolution: '1K'
}
})
});
const task = await response.json();
console.log(`Task ID: ${task.id}`);
console.log(`Status: ${task.status}`);const response = await fetch('https://toapis.com/v1/images/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-ToAPIs-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'flux-2-pro',
prompt: 'Keep character style, generate a scene of running in the forest',
size: '1:1',
image_urls: ['https://example.com/ref1.jpg'],
metadata: {
resolution: '2K'
}
})
});
const task = await response.json();
console.log(`Task ID: ${task.id}`);
console.log(`Status: ${task.status}`);응답 예시
{
"id": "task_img_abc123def456",
"object": "generation.task",
"model": "flux-2-flex",
"status": "queued",
"progress": 0,
"created_at": 1703884800,
"metadata": {}
}