{"openapi":"3.1.0","info":{"title":"海豚 AI 视频生成 API","version":"1.1.0","description":"使用管理员分配的用户 API Key 作为 Bearer Token。用户之间的积分、素材和任务完全隔离。"},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}],"paths":{"/api/v1/jobs":{"get":{"summary":"列出当前用户的视频任务"},"post":{"summary":"创建视频任务","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id","prompt"],"properties":{"id":{"type":"string","format":"uuid","description":"客户端生成的任务 UUID；上传素材时使用同一个 taskId"},"prompt":{"type":"string"},"mode":{"enum":["Reference to video","Image to video","Text to video"]},"duration":{"type":"integer","minimum":4,"maximum":15},"referenceIds":{"type":"array","items":{"type":"string"}}}}}}}}},"/api/v1/uploads":{"post":{"summary":"上传参考素材","description":"使用二进制请求体；taskId 查询参数与创建任务时的 id 相同，文件名放在 X-File-Name。返回的 uploadId 放入 referenceIds。","parameters":[{"name":"taskId","in":"query","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"name","in":"query","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}}}},"/api/v1/jobs/{id}":{"get":{"summary":"查询单个任务；完成后 videoUrl 为高清视频地址","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}]}},"/api/v1/account":{"get":{"summary":"查询当前用户余额和每秒积分费率"}}},"servers":[{"url":"https://api.lcagi.cn"}]}