POST
/api/v1/imagine3 creditsSynchronousRecraft v3
Provider · RecraftType · T2IModel ID ·
recraftUpstream ID · recraftv3Recraft v3. High-quality image generation with a distinct aesthetic, strong at vector-style illustration and consistent design elements. Uses DALL-E 3 compatible request format.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| prompt | string | Required | The text prompt describing the image to generate. |
| model | string | Optional | Set to `recraft` to use this model.Default: recraft |
| aspect_ratio | string | Optional | Output aspect ratio. Allowed: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3.Default: 1:1 |
| webhook_url | string | Optional | URL where we POST the completed task result. |
| webhook_secret | string | Optional | Sent as x-webhook-secret header in webhook delivery for verification. |
Example Request
cURL
curl -X POST https://api.journeyapi.com/api/v1/imagine \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "recraft",
"prompt": "a flat design icon of a rocket ship, bold colors, minimal style",
"aspect_ratio": "1:1"
}'Response
This model is synchronous — the response includes the finished image_url directly. No polling required.
200 OK
{
"task_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "finished",
"image_url": "https://cdn.example.com/output.png"
}Tips
- 1Excellent for brand-consistent illustrations and icon-style art.