Atlas Cloud

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.

2. Set Environment Variable

export ATLASCLOUD_API_KEY="your-api-key-here"

API Architecture

Atlas Cloud has the following API endpoints:

All requests require the following headers:

Authorization: Bearer $ATLASCLOUD_API_KEY
Content-Type: application/json

Full Endpoint List

MCP Tools (14 Tools)

Using this through the Atlas Cloud plugin (no API key needed) The Atlas Cloud Codex 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