{"skill":{"slug":"ai-api-transit-station","displayName":"API-Station","summary":"伝富AI-API文档技能 - 快速查询和使用302+个AI接口，涵盖聊天、图像、视频、音频、Midjourney等多个类别","description":"---\r\nname: AIAPI-Doc\r\ndescription: 伝富AI-API文档技能 - 快速查询和使用302+个AI接口，涵盖聊天、图像、视频、音频、Midjourney等多个类别\r\n---\r\n\r\n# 伝富AI-API 调用技能\r\n\r\n本技能帮助你调用伝富AI-API平台的302+个API接口。当用户需要调用AI能力时，使用此技能。\r\n\r\n## 🔐 关键地址配置\r\n\r\n> [!IMPORTANT]\r\n> 请注意区分以下三个关键地址：\r\n\r\n| 类型              | 地址                              | 说明                              |\r\n| ----------------- | --------------------------------- | --------------------------------- |\r\n| **API请求地址**   | `https://api.winfull.cloud-ip.cc` | 以此开头调用所有接口 (Base URL)   |\r\n| **API官网/Token** | https://api.winfull.cloud-ip.cc/  | 在此注册账户、充值、申请API Token |\r\n| **API文档地址**   | https://winfull.apifox.cn/        | 查阅最新的接口文档、参数说明      |\r\n\r\n**认证方式**: 所有请求必须在Header中携带Bearer Token\r\n\r\n```\r\nAuthorization: Bearer sk-xxxxxxxx\r\n```\r\n\r\n---\r\n\r\n## 📚 API分类速查\r\n\r\n完整文档地址：https://winfull.apifox.cn/\r\n\r\n| 类别       | 接口数 | 说明                                |\r\n| ---------- | ------ | ----------------------------------- |\r\n| 图像生成   | 82     | DALL·E、Flux、豆包、Ideogram、Imagen |\r\n| 视频生成   | 54     | Sora、Veo、可灵、即梦、Minimax      |\r\n| 聊天       | 43     | GPT、Claude、Gemini、DeepSeek       |\r\n| 任务查询   | 33     | 异步任务查询                        |\r\n| 其他       | 24     | 文件上传、模型列表、代码执行等      |\r\n| 函数调用   | 12     | Function Calling、Web搜索           |\r\n| Replicate  | 12     | Replicate平台模型                   |\r\n| 音乐生成   | 9      | Suno音乐生成                        |\r\n| Midjourney | 8      | Midjourney完整功能                  |\r\n| 音频       | 7      | TTS、Whisper、音频理解              |\r\n| 系统API    | 7      | Token管理、用户信息                 |\r\n| 可灵Kling  | 6      | 可灵专属功能                        |\r\n| 文档处理   | 3      | PDF理解、文档解析                   |\r\n| 嵌入       | 2      | Embeddings向量化                    |\r\n\r\n**总计**: 302+ 个API接口\r\n\r\n---\r\n\r\n## 🚀 核心API调用模式\r\n\r\n### 1. 聊天补全 (Chat Completions)\r\n\r\n**端点**: `POST /v1/chat/completions`\r\n\r\n```python\r\nimport requests\r\n\r\nresponse = requests.post(\r\n    \"https://api.winfull.cloud-ip.cc/v1/chat/completions\",\r\n    headers={\r\n        \"Authorization\": \"Bearer sk-xxx\",\r\n        \"Content-Type\": \"application/json\"\r\n    },\r\n    json={\r\n        \"model\": \"gpt-5.2\",\r\n        \"messages\": [\r\n            {\"role\": \"system\", \"content\": \"You are a helpful assistant.\"},\r\n            {\"role\": \"user\", \"content\": \"你好\"}\r\n        ]\r\n    }\r\n)\r\n\r\nresult = response.json()\r\nprint(result[\"choices\"][0][\"message\"][\"content\"])\r\n```\r\n\r\n---\r\n\r\n### 2. 图像生成 (Image Generations)\r\n\r\n**端点**: `POST /v1/images/generations`\r\n\r\n```python\r\nresponse = requests.post(\r\n    \"https://api.winfull.cloud-ip.cc/v1/images/generations\",\r\n    headers={\r\n        \"Authorization\": \"Bearer sk-xxx\",\r\n        \"Content-Type\": \"application/json\"\r\n    },\r\n    json={\r\n        \"model\": \"gpt-image-1.5-all\",\r\n        \"prompt\": \"一只可爱的猫咪在草地上\",\r\n        \"size\": \"1024x1536\"\r\n    }\r\n)\r\n\r\nresult = response.json()\r\nimage_url = result[\"data\"][0][\"url\"]\r\n```\r\n\r\n---\r\n\r\n### 3. 图片上传到图床\r\n\r\n> [!IMPORTANT]\r\n> **图生视频必读**: 如果需要使用本地图片生成视频，必须先将图片上传到图床获取公网URL，然后使用该URL传给视频生成接口。\r\n> \r\n> **两种方式**:\r\n> 1. 上传本地图片到图床（推荐）\r\n> 2. 直接使用已有的公网图片地址\r\n\r\n**端点**: `POST https://imageproxy.zhongzhuan.chat/api/upload`\r\n\r\n```python\r\n# 方式1: 上传本地图片到图床\r\nwith open(\"reference_image.jpg\", \"rb\") as f:\r\n    response = requests.post(\r\n        \"https://imageproxy.zhongzhuan.chat/api/upload\",\r\n        headers={\"Authorization\": \"Bearer sk-xxx\"},\r\n        files={\"file\": f}\r\n    )\r\n\r\nresult = response.json()\r\nimage_url = result[\"url\"]  # 获取图床URL\r\nprint(f\"图片已上传: {image_url}\")\r\n\r\n# 方式2: 直接使用公网图片地址\r\n# image_url = \"https://example.com/your-image.jpg\"\r\n\r\n# 现在可以使用这个URL进行图生视频\r\n```\r\n\r\n**curl示例**:\r\n```bash\r\ncurl --location --request POST 'https://imageproxy.zhongzhuan.chat/api/upload' \\\r\n--header 'Authorization: Bearer <token>' \\\r\n--form 'file=@\"/path/to/your/image.png\"'\r\n```\r\n\r\n---\r\n\r\n### 4. 视频生成 (异步任务)\r\n\r\n**创建视频**: `POST /v1/video/create`\r\n\r\n```python\r\nimport time\r\n\r\n# 如果需要使用参考图，先上传图片到图床\r\nimage_url = None\r\nif use_reference_image:\r\n    with open(\"reference.jpg\", \"rb\") as f:\r\n        upload_response = requests.post(\r\n            \"https://imageproxy.zhongzhuan.chat/api/upload\",\r\n            headers={\"Authorization\": \"Bearer sk-xxx\"},\r\n            files={\"file\": f}\r\n        )\r\n    image_url = upload_response.json()[\"url\"]\r\n    print(f\"参考图已上传: {image_url}\")\r\n\r\n# 步骤1: 创建视频任务\r\nresponse = requests.post(\r\n    \"https://api.winfull.cloud-ip.cc/v1/video/create\",\r\n    headers={\r\n        \"Authorization\": \"Bearer sk-xxx\",\r\n        \"Content-Type\": \"application/json\"\r\n    },\r\n    json={\r\n        \"model\": \"sora-2\",\r\n        \"prompt\": \"一只小狗在草地上奔跑\",\r\n        \"images\": [image_url] if image_url else [],  # 使用图床URL\r\n        \"orientation\": \"portrait\",\r\n        \"duration\": 15\r\n    }\r\n)\r\n\r\nresult = response.json()\r\ntask_id = result[\"id\"]\r\n```\r\n\r\n**查询任务**: `GET /v1/video/query?id={task_id}`\r\n\r\n```python\r\n# 步骤2: 轮询查询任务状态\r\nwhile True:\r\n    result = requests.get(\r\n        f\"https://api.winfull.cloud-ip.cc/v1/video/query?id={task_id}\",\r\n        headers={\"Authorization\": \"Bearer sk-xxx\"}\r\n    ).json()\r\n    \r\n    if result[\"status\"] == \"completed\":\r\n        video_url = result[\"video_url\"]\r\n        print(f\"视频生成成功: {video_url}\")\r\n        break\r\n    elif result[\"status\"] == \"failed\":\r\n        raise Exception(f\"视频生成失败: {result.get('error')}\")\r\n    \r\n    time.sleep(5)\r\n```\r\n\r\n---\r\n\r\n### 5. 语音合成 (TTS)\r\n\r\n**端点**: `POST /v1/audio/speech`\r\n\r\n```python\r\nresponse = requests.post(\r\n    \"https://api.winfull.cloud-ip.cc/v1/audio/speech\",\r\n    headers={\r\n        \"Authorization\": \"Bearer sk-xxx\",\r\n        \"Content-Type\": \"application/json\"\r\n    },\r\n    json={\r\n        \"model\": \"tts-1\",\r\n        \"input\": \"你好，世界！\",\r\n        \"voice\": \"alloy\"\r\n    }\r\n)\r\n\r\nwith open(\"output.mp3\", \"wb\") as f:\r\n    f.write(response.content)\r\n```\r\n\r\n---\r\n\r\n### 6. 语音识别 (Whisper)\r\n\r\n**端点**: `POST /v1/audio/transcriptions`\r\n\r\n```python\r\nresponse = requests.post(\r\n    \"https://api.winfull.cloud-ip.cc/v1/audio/transcriptions\",\r\n    headers={\"Authorization\": \"Bearer sk-xxx\"},\r\n    files={\"file\": open(\"audio.mp3\", \"rb\")},\r\n    data={\"model\": \"whisper-1\"}\r\n)\r\n\r\nresult = response.json()\r\ntranscribed_text = result[\"text\"]\r\n```\r\n\r\n---\r\n\r\n### 7. Midjourney\r\n\r\n**提交Imagine任务**: `POST /mj/submit/imagine`\r\n\r\n```python\r\nresponse = requests.post(\r\n    \"https://api.winfull.cloud-ip.cc/mj/submit/imagine\",\r\n    headers={\r\n        \"Authorization\": \"Bearer sk-xxx\",\r\n        \"Content-Type\": \"application/json\"\r\n    },\r\n    json={\r\n        \"prompt\": \"a beautiful sunset over the ocean --ar 16:9 --v 6\"\r\n    }\r\n)\r\n\r\nresult = response.json()\r\ntask_id = result[\"result\"]\r\n```\r\n\r\n---\r\n\r\n## 📋 异步任务通用流程\r\n\r\n大多数生成类API（视频、音乐、部分图像）都是异步的：\r\n\r\n1. 创建任务 → 获取task_id\r\n2. 轮询查询状态 (pending/processing)\r\n3. 状态变为completed → 获取结果URL\r\n4. 状态变为failed → 处理错误\r\n\r\n**轮询建议**: 间隔5-10秒查询一次任务状态\r\n\r\n---\r\n\r\n## ⚠️ 重要注意事项\r\n\r\n1. **认证方式**: 所有请求必须在Header中携带 `Authorization: Bearer sk-xxxxxxxx`\r\n2. **图生视频流程**: \r\n   - 本地图片必须先上传到图床: `https://imageproxy.zhongzhuan.chat/api/upload`\r\n   - 或使用已有的公网图片URL\r\n   - 然后将URL传给视频生成接口的 `images` 参数\r\n3. **异步轮询**: 视频/音乐生成需要轮询，间隔建议5-10秒\r\n4. **Base URL**: 所有接口都以 `https://api.winfull.cloud-ip.cc` 开头\r\n5. **速率限制**: 合理控制请求频率，避免触发限流\r\n6. **Token计费**: 不同模型计费标准不同，详见官网\r\n\r\n---\r\n\r\n## 📖 详细文档参考\r\n\r\n- **在线API文档**: https://winfull.apifox.cn/\r\n- **完整接口列表**: 查看 `api_list.md` 文件\r\n- **官网/Token管理**: https://api.winfull.cloud-ip.cc/\r\n\r\n---\r\n\r\n## ❓ 常见问题\r\n\r\n### Q1: 如何获取API Token?\r\n访问 https://api.winfull.cloud-ip.cc/ 注册账户，在控制台中申请API Token。\r\n\r\n### Q2: 如何使用本地图片生成视频?\r\n必须先将本地图片上传到图床：\r\n```python\r\n# 1. 上传图片到图床\r\nwith open(\"image.jpg\", \"rb\") as f:\r\n    upload_resp = requests.post(\r\n        \"https://imageproxy.zhongzhuan.chat/api/upload\",\r\n        headers={\"Authorization\": \"Bearer sk-xxx\"},\r\n        files={\"file\": f}\r\n    )\r\nimage_url = upload_resp.json()[\"url\"]\r\n\r\n# 2. 使用图片URL创建视频\r\nvideo_resp = requests.post(\r\n    \"https://api.winfull.cloud-ip.cc/v1/video/create\",\r\n    headers={\"Authorization\": \"Bearer sk-xxx\", \"Content-Type\": \"application/json\"},\r\n    json={\"model\": \"sora-2\", \"prompt\": \"描述\", \"images\": [image_url]}\r\n)\r\n```\r\n\r\n### Q3: 可以直接使用公网图片URL吗?\r\n可以！如果图片已经在公网上，可以直接使用URL，无需上传：\r\n```python\r\nimage_url = \"https://example.com/your-image.jpg\"\r\n# 直接使用这个URL创建视频\r\n```\r\n\r\n### Q4: 异步任务一直处于pending状态怎么办?\r\n- 检查任务ID是否正确\r\n- 等待更长时间（某些模型生成较慢）\r\n- 查看账户余额是否充足\r\n- 联系技术支持\r\n\r\n### Q5: 视频生成需要多长时间?\r\n根据模型和视频长度不同，通常需要1-10分钟。建议每5-10秒轮询一次任务状态。\r\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":720,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1771696900447,"updatedAt":1778491601423},"latestVersion":{"version":"1.0.0","createdAt":1771696900447,"changelog":"A brand new AI service platform, unlocking the door to the future, AI aggregation management.  \nThe most stable official enterprise-level channels across the entire network, with prices as low as 0.95% of the official rate. Register and get $0.2 instantly, with detailed records available; every expenditure is open and transparent.","license":null},"metadata":null,"owner":{"handle":"qb-chen","userId":"s17cqq9nc31y8vrfjtfs0zv3zh83h8xg","displayName":"QB-Chen","image":"https://avatars.githubusercontent.com/u/150009756?v=4"},"moderation":null}