创建会话

POST 
/v1/sessions

为发起调用的终端用户创建一个对话会话。output_format 决定会话整个生命周期内回复的形式，capabilities 或 exclude_capabilities 决定助手在会话里能用什么（两个都不传时为全部能力）。带上 text（还可以像后续消息那样带上 attachments），第一个任务就会立刻开始：这时响应里有它的 task_id；它的回复在 GET /v1/sessions/{session_id}/events 上流式发送——把 Last-Event-ID 设为返回的 last_event_id 打开事件流，就会从第一帧开始收到这个任务——并保存在会话的消息列表里。开启任务需要项目的计费账户有可用余额；创建空会话则不需要。

请求

响应

201

成功响应

401

鉴权失败：凭证缺失、格式错误、已过期或已作废。

• invalid_token — 访问令牌无效。
• project_disabled — 此项目未启用。
• token_expired — 访问令牌已过期。
• user_disabled — 此用户未启用。

404

请求的资源不存在，或对调用方不可见。

• file_not_found — 找不到请求的文件。
• file_expired — 请求的文件已过期。

409

请求与资源的当前状态冲突。

• idempotency_conflict — 这个 Idempotency-Key 属于另一个请求。
• idempotency_in_progress — 带这个 Idempotency-Key 的第一次请求仍在处理中。请稍后用同一个键重试。

413

请求体超过了允许的上限。

• file_too_large — 文件超过了允许的最大大小。
• payload_too_large — 请求体太大。

422

请求中的某个值未通过校验；details 数组会列出每个出错的字段。

• unsupported_media_type — 不支持该媒体类型。
• validation_failed — 请求内容未通过校验。

429

要么是请求太多（Retry-After 响应头会说明何时重试），要么是计费账户的积分已用完（不带 Retry-After——加上积分才能继续）；用 code 字段区分这两种情况。

• insufficient_credits — 计费账户的积分不足。
• rate_limited — 请求太频繁，请放慢速度。

500

服务端发生了意外错误。

• internal — 发生了意外错误。