一、用途:Atlas Cloud 是 AI API 聚合平台,通过统一接口访问 300+ 图像、视频、音频(TTS、音乐、语音转文字)、3D 和 LLM 模型。此技能用于把 Atlas Cloud API 集成到任意项目,并说明其各项工具与端点的调用方式。
二、主要能力与端点:媒体生成 API 基址为 https://api.atlascloud.ai/api/v1,用于图像生成、视频生成、轮询结果与上传媒体;LLM API 基址为 https://api.atlascloud.ai/v1,提供 OpenAI 兼容的 chat completions。请求头需带 Authorization: Bearer $ATLASCLOUD_API_KEY 与 Content-Type: application/json。端点包括 POST /api/v1/model/generateImage、POST /api/v1/model/generateVideo、POST /api/v1/model/generateAudio(TTS、音乐、ASR)、GET /api/v1/model/prediction/{id}、POST /api/v1/model/uploadMedia、POST /v1/chat/completions,以及无需鉴权的 GET api.atlascloud.ai/api/v1/models。
三、MCP 工具与用法:MCP 共 16 个工具,涵盖模型发现(atlas_list_models、atlas_search_docs、atlas_get_model_info)、生成(atlas_generate_image、atlas_generate_video、atlas_generate_audio、atlas_transcribe_audio、atlas_quick_generate、atlas_chat)、实用(atlas_get_prediction、atlas_get_upload_url、atlas_upload_media)与账户(atlas_get_balance、atlas_get_model_usage、atlas_get_model_costs)。生成类任务为异步两步:先提交获得 prediction ID,再轮询结果;图像通常 10-30 秒、每 3 秒轮询一次,视频通常 1-5 分钟。上传本地文件后可将返回 URL 作为 image_url 使用,但仅限生成任务临时用途。
四、凭证与限制:独立服务器需自建 API Key 并设置环境变量 export ATLASCLOUD_API_KEY="your-api-key-here";通过 Codex 插件使用时凭据来自浏览器登录,无需 API Key,授权可运行 codex mcp login atlas-cloud。托管连接器仅暴露 14 个工具,atlas_chat 与 atlas_upload_media 为本地独有。上传文件有默认 32MB 上限且会被定期清理,滥用可能导致 API Key 被停用。3D 模型归为 Image 类型,TTS、音乐与语音转文字归为 Audio 类型,lipsync 与 talking-avatar 归为 Video 类型。不同模型参数不同,调用前建议先查 schema;具体收费与价格暂未提供。