Skip to main content
Every inference submission creates a job. This uniform contract lets you handle fast image reads and long-running generation work in the same way.
succeeded, failed, expired and canceled are terminal statuses.

​
Submit work

Send POST to a model endpoint with an API key. CarHub reserves the worst-case credit price, creates the job and queues it atomically. A 202 response includes a job and a Location header pointing to it. Add ?wait=true on fast endpoints when you prefer an inline result. CarHub waits for at most 30 seconds. If work is still pending, it returns 202 and the job continues. Video, 360 and bundle endpoints reject wait=true with 400 wait_not_supported.

​
Poll a job

Poll with exponential backoff. Stop when the job reaches a terminal status. On success, consume result; on failure, inspect error.type, error.code and error.message rather than parsing human-readable text. For an event-driven integration, use webhooks instead.

​
Make retries safe

Pass a unique Idempotency-Key for each logical submission. Replaying the same key and payload returns the stored original response with Idempotent-Replayed: true. Reusing it for a different payload returns 409 idempotency_key_reuse. Use the same key for transport retries. Generate a new key only when you deliberately create new work.

​
Credits and settlement

At admission, CarHub reserves credits for the job. One credit equals one USD cent, so 20 credits represent $0.20. After processing, CarHub releases the reservation and charges actual use. A failed model job releases its reservation. If the credit balance cannot cover admission, you receive 402 insufficient_credits and no job is created. For endpoint-specific input and output fields, use the generated API reference.