Flows | Overview
Pre-built AI workflow API overview. Multi-step generation pipelines for specific use cases like photo-to-3D miniature figurines, automated in a single API call.
Overview
Flows are specialized endpoints designed for specific creative tasks. Each flow takes a simple input and produces a high quality result, ready to use in your application.
Available Flows
| Flow | Endpoint | Description | Credits |
|---|---|---|---|
| Miniature Figurine | /v1/flow/miniature/ | Transform a photo into a 3D miniature or realistic figurine. Style is applied automatically, just provide the source image. | 200 to 300 |
How It Works
Flows are asynchronous like all generation endpoints. Submit a request with your input, receive a task_id, then poll the status endpoint until the result is ready.
Request
# 1. Submit a flow request
curl -X POST https://api.3daistudio.com/v1/flow/miniature/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"image": "data:image/png;base64,...", "preset": "miniature_human_full_body", "edition": "fast"}'
# 2. Poll for results
curl https://api.3daistudio.com/v1/generation-request/TASK_ID/status/ \
-H "Authorization: Bearer YOUR_API_KEY"Errors
Common errors for flow endpoints.
| Status | Error Code | Description |
|---|---|---|
| 402 | insufficient_credits | Not enough credits. |
| 429 | rate_limited | Rate limit exceeded. |
| 400 | validation_failed | Missing or invalid parameters. |