Skip to content
LLM-friendly formats:

Response Schemas

Complete schemas for all API responses.

Sync Success (200)

HTTP/1.1 200 OK
Content-Type: image/webp
Content-Location: https://cdn.render.weyl.ai/i/xyz.webp
X-Generation-Time: 1847
X-Seed: 42
<binary data>

Sync Capacity Exhausted (503)

HTTP/1.1 503 Service Unavailable
Retry-After: 30
Content-Type: application/json
{
"error": "capacity_exhausted",
"message": "sync tier at capacity, retry in 30s",
"retry_after": 30
}

Async Job Queued (202)

{
"id": "j_abc123",
"status": "queued",
"position": 5,
"eta_seconds": 75,
"created_at": "2024-01-15T10:30:00Z"
}

Async Job Status

Queued

{
"id": "j_abc123",
"status": "queued",
"position": 3,
"eta_seconds": 45
}

Running

{
"id": "j_abc123",
"status": "running",
"progress": 0.65,
"step": 20,
"total_steps": 30,
"eta_seconds": 8
}

Complete (303)

HTTP/1.1 303 See Other
Location: https://cdn.render.weyl.ai/i/xyz.webp

Or with body:

{
"id": "j_abc123",
"status": "complete",
"output": "https://cdn.render.weyl.ai/i/xyz.webp",
"duration_ms": 2340,
"completed_at": "2024-01-15T10:31:23Z"
}

Failed

{
"id": "j_abc123",
"status": "failed",
"error": {
"code": "nsfw_detected",
"message": "Content policy violation"
},
"failed_at": "2024-01-15T10:30:45Z"
}

Headers

Response Headers

  • Content-Location - Permanent CDN URL
  • X-Generation-Time - Latency in milliseconds
  • X-Seed - Seed used for generation
  • Retry-After - Seconds to wait before retry