API reference
Cancel a job
POST
Ask for a queued or processing job to stop. A job that has already finished answers 409.
bearerAuthheader
AuthorizationBearer <token>Your API key, sent as Authorization: Bearer <key>.
id*stringThe job id from the 202 response.
The job, as it stands after the cancel was accepted.
application/json- response
id*stringgeneration_id*stringobject*stringstate*stringValue in
"queued""processing""succeeded""failed""canceled"modality*stringmodel*stringcreated_at*stringFormat
date-timestarted_at?stringFormat
date-timecompleted_at?stringFormat
date-timeprogress*output?array<>usage?error?retry_of?stringop_metadata*curl -X POST "https://example.com/v1/jobs/string/cancel" \ -H "Authorization: Bearer $OP_API_KEY"{ "id": "string", "generation_id": "string", "object": "job", "state": "queued", "modality": "string", "model": "string", "created_at": "2019-08-24T14:15:22Z", "started_at": "2019-08-24T14:15:22Z", "completed_at": "2019-08-24T14:15:22Z", "progress": { "percent": 0, "phase": "string", "queue_position": 0 }, "output": [ { "url": "string", "url_expires_at": "2019-08-24T14:15:22Z", "type": "string", "bytes": 0, "checksum_sha256": "string", "purged_at": "2019-08-24T14:15:22Z" } ], "usage": { "units": { "property1": 0, "property2": 0 }, "cost": { "billing_usd": 0, "cost_source": "string", "cost_status": "string", "price_version": "string" } }, "error": { "code": "string", "kind": "string", "scope": "string", "message": "string" }, "retry_of": "string", "op_metadata": { "generation_id": "string", "requested_model": "string", "retention_class": "string", "region": "string", "policy": [ "string" ] }}Overview
Every endpoint, its request, its response and code samples.
Create a chat completion POST
Send a conversation and get a reply. Set `stream` to true for server-sent events. A request can fail over to another endpoint only before the first content token; after that the stream ends with a terminal frame instead.