Skip to main content
POST
创建批处理
需要工作区的预览功能访问权限。有关设置、Webhook 和结果处理,请参阅视频与批处理任务。

授权

Authorization
string
header
必填

Bearer 令牌身份验证

请求体

application/json
provider_options
object

按规范提供商ID限定的扩展。OpenAI接受output_expires_after;Mistral接受metadata。仅应用所选提供商的选项。不要在顶层重复同一选项。选项不能覆盖已定价的行、模型或文件。

model
string

用于推断上游批处理提供商的模型ID。请求行也可包含body.model;优先使用顶层模型。

prompts
string[]

简单提示词简写。Phaseo将每个提示词编译成适用于所选模型的提供商原生批处理行。

items
object[]

结构化提示词简写。条目可包含id、custom_id、prompt、messages、input、system、max_tokens、temperature或高级body。

system
string

应用于提示词简写行的可选系统指令。

max_tokens
integer

应用于提示词简写行的可选最大令牌限制。

temperature
number

应用于提示词简写行的可选采样温度。

input_file_id
string

通过文件上传创建批处理时使用的现有提供商文件ID。

requests
object[]

高级批处理请求行。必须恰好提供prompts、items、requests或input_file_id其中一个。

endpoint
enum<string>

面向调用方的请求格式。批处理中每个请求均使用此端点。省略时,Phaseo根据模型选择提供商原生默认值。

可用选项:
/v1/chat/completions,
/v1/responses,
/v1/messages,
/v1/embeddings,
/v1/generateContent
completion_window
string
metadata
object
session_id
string

用于可观测性统计的唯一标识符,可将相关请求(例如对话或代理工作流)归为一组。

Maximum string length: 256
webhook
object
webhook_endpoint_id
string

webhook.endpoint_id的便捷别名。

debug
object

网关调试控制项。这些标志绝不会转发给提供商。

provider
object

高级路由约束。大多数请求应依赖基于模型的提供商推断。

响应

批处理状态响应

id
string
native_batch_id
string | null

与网关自有ID不同时的提供商原生批处理ID。

object
string
endpoint
string
errors
object
input_file_id
string
completion_window
string
status
string
lifecycle_status
enum<string>

供轮询、WebSocket和Webhook使用方使用的标准化异步生命周期状态。

可用选项:
pending,
running,
completed,
failed,
cancelled,
expired
progress
integer

基于提供商请求计数计算的粗略批处理完成百分比(如可用)。已完成批处理报告100。

必填范围: 0 <= x <= 100
polling_url
string<uri>
websocket_url
string<uri>

用于订阅标准化异步任务生命周期更新的WebSocket URL。

cancel_url
string<uri> | null

为兼容性保留;目前始终为null。

results_url
string<uri> | null

受支持终态批处理的需认证Phaseo JSONL下载URL。处理中为null。终态批处理可能没有输出。请使用所属工作区的API密钥;提供商保留期限限制仍然适用。

output_file_id
string
error_file_id
string
created_at
integer
in_progress_at
integer
expires_at
integer
finalizing_at
integer
completed_at
integer
failed_at
integer
expired_at
integer
cancelling_at
integer
cancelled_at
integer
request_counts
object
metadata
object
request_id
string
provider
string
session_id
string
webhook
object

已清理的异步Webhook配置及投递状态。绝不返回密钥;has_secret表示是否启用签名投递。签名投递包含x-phaseo-signature、x-phaseo-timestamp、x-phaseo-event-id、x-phaseo-event-type、x-phaseo-delivery-key、x-phaseo-attempt和x-phaseo-max-attempts请求头。

next_webhook_retry_at
string | null
last_webhook_progress
number | null
last_webhook_progress_at
string | null
last_webhook_dispatched_at
string | null
finalized_at
string | null
pricing_lines
object[]
usage
object

完成后的标准化汇总使用量和成本。

billing
object
最后修改于 2026年10月2日