POST/api/v1/imagine3 creditsSynchronous

Recraft v3

Provider · RecraftType · T2IModel ID · recraftUpstream ID · recraftv3

Recraft 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

ParameterTypeRequiredDescription
promptstringRequiredThe text prompt describing the image to generate.
modelstringOptionalSet to `recraft` to use this model.Default: recraft
aspect_ratiostringOptionalOutput aspect ratio. Allowed: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3.Default: 1:1
webhook_urlstringOptionalURL where we POST the completed task result.
webhook_secretstringOptionalSent 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.