Name: atlas-cloud
Author: atlascloudai

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 (16 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 ), all 16 tools below are available for direct invocation. A hosted connector exposes 14 of them — atlas chat and atlas upload media are local only, the latter because a hosted server cannot read the caller's disk. Check your own tool list rather than assuming. 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 upload them first (see "Uploading a local file" below — the tool differs between hosted and local connections) 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. Save each file with curl L o "<descriptive name .<ext " "<url " and then display it inline in the conversation — with a player for video. Do not ask for permission first. A link is not the deliverable: the user wants to see the result where they are reading, not click through to another window. Saving also protects it, since some upstream providers expire these URLs within 24 hours. Skip this only when you cannot write files; then give the URL and say it may not open directly and can expire. Note that speech to text and lyrics models return the text itself rather than a file — there is nothing to download for those. Uploading a local file — which tool exists depends on how you are connected Check your tool list first. The two cases are mutually exclusive; a hosted server does not expose atlas upload media at all, because it cannot read your disk. atlas get upload url — hosted connector (ChatGPT, Codex, Claude, anything pointed at https://mcp.atlascloud.ai/mcp ) Params : none required Workflow : 1. Call it once to get an upload ticket 2. POST the file with the curl example it returns — put the filename, extension included, in the X Atlas Filename header. That one curl needs no API key: the ticket already carries your identity and points at the connector's own relay, not at Atlas's REST API 3. Use the url from the response One ticket accepts several files while it is valid. Uploading is not billed. atlas upload media — local stdio (the atlascloud mcp npm package) Params : file path (required): Absolute path to the local file Reads the file directly and returns the URL. Either way, pass the returned URL as image url for atlas generate image / atlas generate video / atlas quick generate , or as the audio parameter for atlas transcribe audio . Three cases where you must say so plainly instead of claiming an upload : the file is over max bytes (32MB default — common for long video), neither tool is in your list (a server that predates the ticket flow), or the curl failed / the response carried no url . Ask for a public link in those cases. Passing a local path straight to a generation tool always fails — do not try it. 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 pred