POST
/
openai
/
v1
/
batches
Create batch
curl --request POST \
  --url https://api.novita.ai/openai/v1/batches \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '{
  "input_file_id": "<string>",
  "endpoint": "<string>",
  "completion_window": "<string>"
}'
{
  "id": "<string>",
  "object": "<string>",
  "endpoint": "<string>",
  "input_file_id": "<string>",
  "output_file_id": "<string>",
  "error_file_id": "<string>",
  "completion_window": "<string>",
  "in_progress_at": {},
  "expires_at": {},
  "finalizing_at": {},
  "completed_at": {},
  "failed_at": {},
  "expired_at": {},
  "cancelling_at": {},
  "cancelled_at": {},
  "status": "<string>",
  "errors": "<string>",
  "version": 123,
  "created_at": "<string>",
  "updated_at": {},
  "created_by": "<string>",
  "created_by_key_id": "<string>",
  "remark": "<string>",
  "total": 123,
  "completed": 123,
  "failed": 123,
  "metadata": {},
  "request_counts": {
    "total": 123,
    "completed": 123,
    "failed": 123
  }
}
After successfully uploading the input file, initiate a batch by using the ID of the uploaded file. Note that the completion window is set to a fixed duration of 48 hours and cannot be modified.

​
Request Headers

​
Content-Type
string
required
Enum: application/json
​
Authorization
string
required
Bearer authentication format, for example: Bearer {{API Key}}.

​
Request Body

​
input_file_id
string
required
ID of the uploaded input file containing batch requests
​
endpoint
string
required
The endpoint to use for batch processing. Available endpoints are /v1/chat/completions and /v1/completions.
Set the endpoint parameter to /v1/chat/completions or /v1/completions for OpenAI API compatibility.
​
completion_window
string
Time window for batch completion. The completion window is fixed at 48h and is currently non-adjustable.

​
Response

​
id
string
required
A unique identifier for the batch job.
​
object
string
required
The object type, which is always batch.
​
endpoint
string
required
The API endpoint that the batch job is using for processing requests.
​
input_file_id
string
required
The ID of the input file containing the batch requests.
​
output_file_id
string
required
The ID of the output file containing the batch results. Empty until the batch is completed.
​
error_file_id
string
required
The ID of the error file containing any errors that occurred during batch processing. Empty until errors occur.
​
completion_window
string
required
The time window for batch completion. Currently fixed at 48h.
​
in_progress_at
string | null
The timestamp when the batch started processing. Null if not yet started.
​
expires_at
string | null
The timestamp when the batch will expire. Null if not set.
​
finalizing_at
string | null
The timestamp when the batch started finalizing. Null if not yet finalizing.
​
completed_at
string | null
The timestamp when the batch was completed. Null if not yet completed.
​
failed_at
string | null
The timestamp when the batch failed. Null if not failed.
​
expired_at
string | null
The timestamp when the batch expired. Null if not expired.
​
cancelling_at
string | null
The timestamp when the batch started cancelling. Null if not cancelling.
​
cancelled_at
string | null
The timestamp when the batch was cancelled. Null if not cancelled.
​
status
string
required
The current status of the batch job.Available statuses:
  • VALIDATING - The input file is being validated before the batch can begin
  • PROGRESS - Batch is in progress
  • COMPLETED - Batch processing completed successfully
  • FAILED - Batch processing failed
  • EXPIRED - Batch exceeded deadline
  • CANCELLING - Batch is being cancelled
  • CANCELLED - Batch was cancelled
​
errors
string
Error messages if any errors occurred during batch processing.
​
version
integer
required
The version number of the batch job.
​
created_at
string
required
The timestamp when the batch job was created.
​
updated_at
string | null
The timestamp when the batch job was last updated. Null if never updated.
​
created_by
string
required
The unique identifier of the user who created the batch job.
​
created_by_key_id
string
required
The API key ID used to create the batch job.
​
remark
string
Optional remark or note for the batch job.
​
total
integer
required
The total number of requests in the batch.
​
completed
integer
required
The number of completed requests in the batch.
​
failed
integer
required
The number of failed requests in the batch.
​
metadata
object | null
Additional metadata associated with the batch job. Null if no metadata is provided.
​
request_counts
object
required
Detailed request count information.