提交 3D 生成任务

默认 API 入口 api.crazyrouter.com

https://api.crazyrouter.com

POST

/v1/3d/submit

文生 / 图生 3D 模型（腾讯混元 hy-3d 系列：hy-3d-3.1、hy-3d-3.0、hy-3d-component）。请求体沿用统一任务格式，image / images[0] / input_reference 任一字段都会作为参考图 image_url 传给上游；input 与 metadata 内的字段原样透传。

结果查询用 GET /v1/3d/query/{task_id}，成功时 url 优先返回 GLB 文件（其次 OBJ / ZIP）。按任务计费，提交时预扣、失败退回。

代码事实源：router/video-router.go（videoV1Router.POST("/3d/submit")）、relay/channel/task/tencent/adaptor.go（buildMaaS3DRequestBody）。

最后校验/修改：2026-09-28（API Base URL 统一为 https://api.crazyrouter.com，示例模型名以 GET /v1/models 返回为准）；实测：hy-3d-3.0 / 3.1 / component 均在目录中；缺 prompt/图片时由上游校验，返回 502 {code:InvalidParameter.InvalidParameter}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200成功

application/json

Bodyapplication/json

🔴502上游未返回任务 ID

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.crazyrouter.com/v1/3d/submit' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "model": "hy-3d-3.1",
  "prompt": "a low-poly ceramic teapot with a wooden handle",
  "image": "https://media.crazyrouter.com/task-artifacts/tmp-inputs/2026/09/28/user-1/teapot.png"
}'

Response Example

200 - 成功示例

{
  "id": "3d_1f9a7c2e",
  "task_id": "3d_1f9a7c2e",
  "status": "queued",
  "progress": 10,
  "created_at": 1790000000,
  "model": "hy-3d-3.1"
}

Modified at 2026-09-28 09:02:00

创建判定 Decisions

查询 3D 生成任务