atlas-cloud-media

Atlas Cloud Media

Overview

Use Atlas Cloud's asynchronous media API to generate images or videos. This source-only skill describes model discovery, schema validation, task submission, bounded polling, and safe output retrieval; it does not bundle an SDK, executable, or hosted runtime.

When to Use This Skill

• Use when the user explicitly asks to generate an image or video with Atlas Cloud.
• Use when an existing workflow needs an Atlas Cloud image or video generation request and can make HTTPS calls.
• Use when model-specific parameters must be discovered before submission.
• Do not use this skill for OpenAI-compatible text chat; that API has a different base URL and contract.

Preconditions

1. Confirm the user is authorized to send the prompt and any reference media to a third-party service.
2. Explain that generation is paid and obtain approval before submitting a billable request.
3. Require ATLASCLOUD_API_KEY to be present in the environment. Never ask the user to paste it into chat, source files, command history, or logs.
4. Confirm the output directory and whether the user wants image generation, video generation, or both.

API Contract

Operation	Method and endpoint
List models	GET https://api.atlascloud.ai/api/v1/models
Generate image	POST https://api.atlascloud.ai/api/v1/model/generateImage
Generate video	POST https://api.atlascloud.ai/api/v1/model/generateVideo
Poll task	GET https://api.atlascloud.ai/api/v1/model/prediction/{id}

Generation and polling requests use these headers:

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

The model catalog is public. Each catalog entry includes a schema URL; fetch that schema and validate parameters against it before sending a paid request. Do not guess parameters from another model, because names such as size, ratio, aspect_ratio, image, and image_url are model-specific.

Workflow