跳转到正文
GatewayOpenAPI

List tasks

GET/api/gateway/v1/tasks

Reads and cancellation use the original frozen task identity, not current model configuration. The key must retain modelInvoke and permission for the original project and route. Task recovery remains available during financial recovery subject to current identity and product authorization. Unknown or expired tasks may have been submitted: inspect and reconcile the existing task before creating another invocation. HTTP disconnect does not cancel a task.

组织 API Key 鉴权

Authorization: Bearer $SINECLOUD_API_KEY

所需权限: modelInvoke

参数

limit · query · 可选
cursor · query · 可选
Opaque nextCursor from the preceding page; takes precedence over before.
before · query · 可选
Alternative pagination cursor when cursor is absent.
routeId · query · 可选
Filter by an authorized original route.
x-sine-project-id · header · 可选
Select an organization project. A project-restricted key defaults to its bound project and cannot select another project. The projectId query parameter takes precedence.
projectId · query · 可选
Optional project selection; takes precedence over x-sine-project-id and must respect the key restriction.

响应

200
Visible tasks with an opaque nextCursor.
400
Invalid request, project identifier, unsupported model parameters or operation configuration.
401
Missing, expired, revoked or invalid organization Bearer API key.
403
The key scope, project restriction, route policy, current membership or product entitlement denies access.
404
The project, route or authorized task was not found.
429
Rate or concurrency limit reached. Honor Retry-After when returned.
500
Sanitized Cloud or Gateway failure.
503
Gateway or durable task execution is unavailable. Restore the required service before continuing.

正在加载 API 参考文档…

Gateway · 接入与鉴权

基础 URLhttps://sinecloud.dev/api/gateway/v1

首次调用前

在控制台选择组织、准备资源,并创建具有所需产品权限范围的组织 API Key。每次调用都会检查当前权限、资源访问权限、预算和可用资金。

从模型目录选择可用路由,并将其 ID 用作 model。接口目录涵盖模型发现、聊天补全、Responses、Messages、嵌入、图像、音频、生成和持久化任务生命周期。请使用对应原生协议,保留 JSON、SSE 流式、multipart 及二进制请求与响应格式,在控制台核对当前模型权限、支持的操作和计费。

查询路由需要 modelRead,推理和任务操作需要 modelInvoke。每次请求都会检查项目限制和路由策略。托管路由需要可用资金与预算,自备密钥路由使用组织的供应商凭据。请保留原始任务 ID,并在重试结果不明确的调用前查询持久化状态。

组织密钥鉴权与基础 URL

产品 API 的生产源地址是 https://sinecloud.dev,不是文档站点。路径前缀为 /api/gateway/v1。请使用接口注明的完整路径,并将资源 ID、模型与端点版本替换为实际值。

Authorization: Bearer $SINECLOUD_API_KEY

将 SINECLOUD_API_KEY 设置为你自己的环境变量值,切勿使用平台服务凭据。各接口的 x-sinecloud-scopes 会注明所需的权限范围。

此文档为只读参考,请在控制台或自己的客户端中发起请求。浏览文档不会创建密钥、启动执行或产生执行费用。请保留请求 ID 和执行回执;连接中断不会取消任务,再次提交前请按接口说明恢复并确认状态。

控制台

输入关键词开始搜索…

↑↓ 移动↵ 选择Esc 关闭