Atlas Cloud API integration skill — quickly call 300+ AI image generation, video generation, audio (TTS, music, speech-to-text), 3D generation, and LLM models through a unified API. Use this skill when the user needs to integrate AI image generation (e.g., Flux, Seedream, DALL-E), AI video generatio

Atlas Cloud API Integration Guide Atlas Cloud is an AI API aggregation platform that provides access to 300+ image, video, audio (TTS · music · speech to text), 3D, and LLM models through a unified interface. This skill helps you quickly integrate Atlas Cloud API into any project. Quick Start 1. Get an API Key Create an API Key at [Atlas Cloud Console](https://www.atlascloud.ai/console/api keys). 2. Set Environment Variable API Architecture Atlas Cloud has the following API endpoints: Endpoint Base URL Purpose Media Generation API https://api.atlascloud.ai/api/v1 Image generation, video generation, poll results, upload media LLM API https://api.atlascloud.ai/v1 Chat completions (OpenAI compatible) All requests require the following headers: Full Endpoint List Method Endpoint Description POST /api/v1/model/generateImage Submit image generation task POST /api/v1/model/generateVideo Submit video generation task POST /api/v1/model/generateAudio Submit audio task — TTS, music generation, speech to text (ASR) GET /api/v1/model/prediction/{id} Check generation task status and result POST /api/v1/model/uploadMedia Upload local media file to get a public URL POST /v1/chat/completions LLM chat (OpenAI compatible format) GET api.atlascloud.ai/api/v1/models List all available models (no auth required) MCP Tools (14 Tools) Using this through the Atlas Cloud plugin (no API key needed) The [Atlas Cloud Codex plugin](https://github.com/AtlasCloudAI/atlas cloud plugin) ships a remote MCP server ( atlas cloud ) whose credentials come from one browser sign in by the user , not from ATLASCLOUD API KEY . Generation is billed to the user's own Atlas account. In that environment: Do not ask the user to create, copy or paste an API key, and do not use the npx atlascloud mcp install below — that route is for a standalone server with its own key. When authorization is needed, tell the user to click "Authenticate" on the plugin, or run codex mcp login atlas cloud . Everything else on this page still applies: the tool names, parameters, the mandatory two call billing flow, and every reference doc. Only the credential differs. When the user wants to integrate Atlas into their own project , keep following the references below — that case does need their own API key. Rule of thumb: "generate X for me" → use the tools; "help me integrate X" → give them code. If the user has installed the Atlas Cloud MCP Server ( npx atlascloud mcp ), the following 14 tools are available for direct invocation: Model Discovery Tools atlas list models — List All Models Params : type (optional): "Text" "Image" "Video" "Audio" Type notes : 3D models are Image type; TTS, music, and speech to text models are Audio type; lipsync / talking avatar models are Video type Purpose : List all available models, optionally filtered by type Examples : No params to list all; type="Image" for image models only atlas search docs — Search Models & Docs Params : query (required): Search keyword matching model names, types, providers, tags Purpose : Fuzzy search models by keyword. Returns detailed API schema info when there's only one match Examples : "video generation" , "deepseek" , "image edit" , "qwen" atlas get model info — Get Model Details Params : model (required): Model ID, e.g. "deepseek ai/deepseek v3.2" Purpose : Get full model info including API docs, input/output schema, pricing, cURL examples, Playground link Examples : model="deepseek ai/deepseek v3.2" Generation Tools atlas generate image — Generate Image Params : model (required): Exact image model ID params (required): Model specific parameter JSON object (e.g. prompt , image size , etc.) Purpose : Submit image generation task, returns prediction ID. Must verify model ID first via atlas list models or atlas search docs Returns : prediction ID — use atlas get prediction to check result atlas generate video — Generate Video Params : model (required): Exact video model ID params (required): Model specific parameter JSON object (e.g. prompt , duration , aspect ratio , image url , etc.) Purpose : Submit video generation task, returns prediction ID Returns : prediction ID — video generation typically takes 1 5 minutes atlas generate audio — Generate Audio (TTS & Music) Params : model (required): Exact audio model ID (e.g. "bytedance/seed audio 1.0" , "suno/chirp v5" , "minimax/music 2.6" ) params (required): Model specific JSON — TTS models usually take text ; music models usually take prompt and/or lyrics Purpose : Submit audio generation task — covers BOTH text to speech and music/song generation Returns : prediction ID — the output is an audio file URL atlas transcribe audio — Transcribe Audio (Speech to Text) Params : model (required): Exact speech to text model ID (e.g. "bytedance/seed asr 2.0" ) params (required): Model specific JSON — main field is usually audio url ; for local files call atlas upload media first Purpose : Transcribe speech to text (ASR) — meetings, interviews, voice notes Returns : prediction ID — the output is the transcribed text atlas quick generate — Quick Generate (One Step) Params : model keyword (required): Model search keyword, e.g. "nano banana" , "seedream" , "kling v3" type (required): "Image" "Video" "Audio" prompt (required): Text description of what to generate image url (optional): Source image URL for image to video, image editing, image to 3D, or talking avatar models audio url (optional): Source audio URL for lipsync / talking avatar or speech to text models extra params (optional): Additional model specific parameters to override defaults Purpose : One step generation — automatically searches model → fetches schema → builds params → submits task. No need to know exact model IDs Examples : model keyword="seedream v5", type="Image", prompt="a cute cat" atlas chat — LLM Chat Params : model (required): LLM model ID messages (required): Array of message objects with role and content temperature (optional): Sampling temperature 0 2 max tokens (optional): Maximum response tokens top p (optional): Nucleus sampling parameter 0 1 Purpose : Send OpenAI compatible chat completion request Utility Tools atlas get prediction — Check Generation Result Params : prediction id (required): Prediction ID returned from a generation request Purpose : Check image/video generation task status and result Status values : starting → processing → completed / succeeded / failed On completion : Returns output URL list — can download locally via curl/wget atlas upload media — Upload Media File Params : file path (required): Absolute path to the local file Purpose : Upload local image/media file to Atlas Cloud and get a publicly accessible URL. Use this to provide image url for image editing or image to video models Workflow : 1. Upload local file with this tool to get a URL 2. Use the returned URL as the image url parameter for atlas generate image , atlas generate video , or atlas quick generate Note : Only for Atlas Cloud generation tasks. Uploaded files are temporary and will be cleaned up periodically. Uploading content unrelated to generation tasks (e.g., bulk hosting, illegal content, or abuse) may result in API key suspension Account Tools atlas get balance — Account Balance Params : none Purpose : Get the account balance and credit summary for the current API key atlas get model usage — Daily Usage Params : start date , end date (optional date range) Purpose : Per day model usage (requests, tokens, image/video counts) atlas get model costs — Daily Costs Params : start date , end date (optional date range) Purpose : Per day spend buckets per model Image Generation Image generation is an asynchronous two step process: submit task → poll result . Submit Image Generation Task Request body: Response: Different models accept different parameters. Common parameters include: prompt (required): Image description image size / width + height : Dimensions num inference steps : Inference steps guidance scale : Guidance scale image url : Input image (for image to image models) Poll Generation Result Response: Possible status values: starting → processing → completed / failed Image generation typically takes 10 30 seconds . Poll every 3 seconds . Video Generation Video generation follows the exact same flow as image generation, just with a different endpoint. Submit Video Generation Task Request body: Common video model parameters: prompt (required for T2V): Video description image / image url : Input image (for image to video models — Seedance 2.5 uses image , Kling uses image url ) duration : Video duration in seconds (Seedance 2.5 supports 4 30, Seedance 2.0 supports 4 15, or 1 for auto) resolution : "480p" / "720p" / "1080p" native; Seedance 2.5 also takes sr / esr upscale tiers up to "4k sr" aspect ratio / ratio : Aspect ratio (e.g., "16:9" , "9:16" , "1:1" , "21:9" , "adaptive" ) generate audio : Seedance 2.5 / 2.0 generate synchronized native audio (voice/SFX/BGM) jointly with video. Default true web search : Seedance T2V only — enable to ground generation in real world references. Default false Different video models accept different parameters. Always call atlas get model info or fetch the schema first for unfamiliar models. Poll results using the same prediction endpoint. Video generation typically takes 1 5 minutes (Fast variants 30 90s). Full Power Pipeline via Atlas Cloud Workflow For workloads that need the unrestricted / full capability build — looser guardrails, broader subject coverage, and maximum fidelity output that goes beyond the standard API's content policy — route the job through [Atlas Cloud Workflow](https://www.atlascloud.ai/console/workflow). It's the same account, same API key, same polling contract; just a different submission entry point designed for advanced production use. Use this when the default Seedance 2.5 endpoint rejects a legitimate creative prompt or clamps stylistic range. Point the user to Atlas Cloud Workflow if they hit refusals on non violating prompts. Upload Media Upload a local file to Atlas Cloud to get a publicly accessible URL. This is required when you need to provide an image url to image editing or image to video models but only have a local file. Upload Endpoint Request: multipart form data with a file field containing the file binary. Response: Workflow: Local Image → Image to Video 1. Upload local image → get URL 2. Use URL as image url parameter in generation request Important : This upload endpoint is strictly for temporary use with Atlas Cloud generation tasks. Uploaded files will be cleaned up periodically. Do NOT use this as permanent file hosting, CDN, or for any purpose unrelated to Atlas Cloud image/video generation. Abuse (e.g., bulk uploads, hosting illegal or unrelated content) may result in immediate API key suspension. LLM Chat API (OpenAI Compatible) The LLM API is fully compatible with the OpenAI format. You can use the OpenAI SDK directly. Request body: Response (standard OpenAI format): Using OpenAI SDK Since Atlas Cloud LLM API is fully OpenAI compatible, you can use the official SDKs directly: Python: Node.js / TypeScript: Code Templates For full implementation code with

atlas-cloud