Create New Batch

Create a message batch

post

Create a batch of messages for asynchronous processing. All usage is charged at 50% of the standard API prices.

Header parameters

AuthorizationstringRequiredExample: sk-mx9BKfEmsSr

Body

application/json

Responses

200Success

application/json

batch_idstringRequired

file_idstringRequired

task_idintegerRequired

task_statusstringRequired

post

/v1/batches

HTTPcURLJavaScriptPython

POST /v1/batches HTTP/1.1
Host: llm.onerouter.pro
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 1077

{
  "requests": [
    {
      "custom_id": "my-request-01",
      "params": {
        "model": "gpt-4o-mini-batch",
        "max_tokens": 1024,
        "messages": [
          {
            "role": "user",
            "content": "How to learn nestjs?"
          }
        ],
        "metadata": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "stop_sequences": [
          "text"
        ],
        "system": "text",
        "temperature": 1,
        "tool_choice": null,
        "tools": [],
        "top_k": 1,
        "top_p": 1,
        "thinking": {
          "budget_tokens": 1024,
          "type": "enabled"
        }
      }
    },
    {
      "custom_id": "my-request-02",
      "params": {
        "model": "gpt-4o-mini-batch",
        "max_tokens": 1024,
        "messages": [
          {
            "role": "user",
            "content": "How to learn Reactjs?"
          }
        ],
        "metadata": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "stop_sequences": [
          "text"
        ],
        "system": "text",
        "temperature": 1,
        "tool_choice": null,
        "tools": [],
        "top_k": 1,
        "top_p": 1,
        "thinking": {
          "budget_tokens": 1024,
          "type": "enabled"
        }
      }
    },
    {
      "custom_id": "my-request-03",
      "params": {
        "model": "gpt-4o-mini-batch",
        "max_tokens": 1024,
        "messages": [
          {
            "role": "user",
            "content": "How to learn Nextjs?"
          }
        ],
        "metadata": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "stop_sequences": [
          "text"
        ],
        "system": "text",
        "temperature": 1,
        "tool_choice": null,
        "tools": [],
        "top_k": 1,
        "top_p": 1,
        "thinking": {
          "budget_tokens": 1024,
          "type": "enabled"
        }
      }
    }
  ]
}

200Success

{
  "batch": {
    "cancelled_at": None,
    "cancelling_at": None,
    "completed_at": None,
    "completion_window": "24h",
    "created_at": 1765972352,
    "endpoint": "",
    "error_file_id": "",
    "errors": None,
    "expired_at": None,
    "expires_at": 1766058749,
    "failed_at": None,
    "finalizing_at": None,
    "id": "batch_a34c321b-ed4b-4e91-ae29-7f02939d8962",
    "in_progress_at": None,
    "input_file_id": "file-142b17fbff7d4a06a88ec9205ae143c9",
    "metadata": None,
    "object": "batch",
    "output_file_id": "",
    "request_counts": {
      "completed": 0,
      "failed": 0,
      "total": 0
    },
    "status": "validating"
  },
  "batch_id": "batch_a34c321b-ed4b-4e91-ae29-7f02939d8962",
  "file": {
    "bytes": 802,
    "created_at": 1765972347,
    "filename": "batch.jsonl",
    "id": "file-142b17fbff7d4a06a88ec9205ae143c9",
    "object": "file",
    "purpose": "batch",
    "status": "processed"
  },
  "file_id": "file-142b17fbff7d4a06a88ec9205ae143c9",
  "task_id": 2,
  "task_status": "NOT_START"
}