Task guides
One guide per task the source names: language (chat), classification, image, video, audio, and document processing as the combination of vision and language. Each says whether the task is synchronous (POST /v1/tasks) or asynchronous (POST /v1/jobs), and which route carries it.
| Task | Route | Mode |
|---|---|---|
| Language (chat) | POST /v1/chat/completions | Synchronous, streamed or not, on POST /v1/chat/completions. |
| Classification | POST /v1/tasks, POST /v1/jobs | Synchronous on POST /v1/tasks; as a job on POST /v1/jobs for a large batch. |
| Image | POST /v1/tasks, POST /v1/jobs | Synchronous on POST /v1/tasks within the synchronous limits; long or batched generation on POST /v1/jobs. |
| Video | POST /v1/tasks, POST /v1/jobs | Asynchronous only, on POST /v1/jobs. |
| Audio | POST /v1/tasks, POST /v1/jobs | Synchronous on POST /v1/tasks within the synchronous limits; POST /v1/jobs for long media. |
| Document processing | POST /v1/tasks, POST /v1/jobs | The language step on POST /v1/chat/completions with image_url parts; the specialist steps (classification, detection, embedding) on POST /v1/tasks. |
- Task
- Language (chat)
- Route
POST /v1/chat/completions- Mode
- Synchronous, streamed or not, on
POST /v1/chat/completions.
- Task
- Classification
- Route
POST /v1/tasks,POST /v1/jobs- Mode
- Synchronous on
POST /v1/tasks; as a job onPOST /v1/jobsfor a large batch.
- Task
- Image
- Route
POST /v1/tasks,POST /v1/jobs- Mode
- Synchronous on
POST /v1/taskswithin the synchronous limits; long or batched generation onPOST /v1/jobs.
- Task
- Video
- Route
POST /v1/tasks,POST /v1/jobs- Mode
- Asynchronous only, on
POST /v1/jobs.
- Task
- Audio
- Route
POST /v1/tasks,POST /v1/jobs- Mode
- Synchronous on
POST /v1/taskswithin the synchronous limits;POST /v1/jobsfor long media.
- Route
POST /v1/tasks,POST /v1/jobs- Mode
- The language step on
POST /v1/chat/completionswithimage_urlparts; the specialist steps (classification, detection, embedding) onPOST /v1/tasks.
| Model type | Shape | Route |
|---|---|---|
| Language model, text in and out | OpenAI | POST /v1/chat/completions, later /v1/responses |
| Language model with image input (vision) | OpenAI image_url parts | POST /v1/chat/completions |
| Image generation and editing | HIPS task | POST /v1/tasks; long or batched generation POST /v1/jobs |
| Audio: transcription, translation, speech | HIPS task | POST /v1/tasks within the synchronous limits; POST /v1/jobs for long media |
| Embeddings | HIPS task | POST /v1/tasks, task embedding |
| Video generation and understanding | HIPS job | POST /v1/jobs only |
| Classification, detection, specialist models | HIPS task | POST /v1/tasks |
| Customer-owned language model | OpenAI | POST /v1/chat/completions with model: dep_... |
| Customer-owned model of any other type | HIPS task | POST /v1/tasks or POST /v1/jobs with deployment: dep_... |
- Model type
- Language model, text in and out
- Shape
- OpenAI
- Route
POST /v1/chat/completions, later/v1/responses
- Model type
- Language model with image input (vision)
- Shape
- OpenAI
image_urlparts - Route
POST /v1/chat/completions
- Model type
- Image generation and editing
- Shape
- HIPS task
- Route
POST /v1/tasks; long or batched generationPOST /v1/jobs
- Model type
- Audio: transcription, translation, speech
- Shape
- HIPS task
- Route
POST /v1/taskswithin the synchronous limits;POST /v1/jobsfor long media
- Model type
- Embeddings
- Shape
- HIPS task
- Route
POST /v1/tasks, taskembedding
- Model type
- Video generation and understanding
- Shape
- HIPS job
- Route
POST /v1/jobsonly
- Model type
- Classification, detection, specialist models
- Shape
- HIPS task
- Route
POST /v1/tasks
- Model type
- Customer-owned language model
- Shape
- OpenAI
- Route
POST /v1/chat/completionswithmodel: dep_...
- Model type
- Customer-owned model of any other type
- Shape
- HIPS task
- Route
POST /v1/tasksorPOST /v1/jobswithdeployment: dep_...
Related sheets
- Sheet
- 06 of 13
- Detail
- A
- Updated
- 2026-10-21
- Status
- Preview