### API Response Example

Source: https://www.atlascloud.ai/docs/more-models/alibaba/wan-2.1-i2v-480p-lora/generateVideo

Example JSON response from the video generation API, showing processing status and output URLs.

```json
{
  "id": "7hm7nbwarxrm80cnq1yvmxz4m4",
  "logs": "...",
  "urls": {
    "cancel": "http://example.com",
    "result": "http://example.com"
  },
  "input": {
    "model": "alibaba/wan-2.1/i2v-480p-lora",
    "seed": -1,
    "size": "832*480",
    "image": "https://static.atlascloud.ai/media/images/1750658282249200177_77kFBzvt.jpg",
    "loras": [
      {
        "path": "Remade-AI/Deflate",
        "scale": 1
      }
    ],
    "prompt": "The video opens with a woman. As the video progresses, the woman begins to  d3d1at3 deflate it, gradually shrinking and losing shape, eventually flattening completely into a lifeless, deflated mass on the ground",
    "duration": 5,
    "flow_shift": 3,
    "guidance_scale": 5,
    "negative_prompt": "string",
    "num_inference_steps": 30,
    "enable_safety_checker": true,
    "enable_prompt_optimizer": false
  },
  "model": "black-forest-labs/flux-dev",
  "output": [
    "https://replicate.delivery/..."
  ],
  "status": "processing",
  "created_at": "2025-03-21T11:36:30.151Z",
  "has_nsfw_contents": [
    false
  ]
}
```

--------------------------------

### Generate Video with alibaba/wan-2.2/i2v-720p

Source: https://www.atlascloud.ai/docs/more-models/alibaba/wan-2.2-i2v-720p/generateVideo

Generates a video using the alibaba/wan-2.2/i2v-720p model. Requires Bearer token authorization and a JSON body with model, image, and prompt.

```bash
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
  -H "Authorization: Bearer " \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-2.2/i2v-720p",
    "image": "https://static.atlascloud.ai/media/images/1753542361521277039_dnDzwtqo.jpeg",
    "prompt": "A futuristic soldier activates a holographic map inside a high-tech command center, flickering lights, intense atmosphere"
  }'
```

--------------------------------

### List Model Costs with Various Filters

Source: https://www.atlascloud.ai/docs/public-api/model-costs

Example cURL request to fetch model costs, demonstrating the use of start and end dates, scope, grouping by model and API key, filtering by model types and IDs, API key IDs, and setting a limit. Includes an empty Authorization header.

```curl
curl -X GET "https://api.atlascloud.ai/public/v1/model-costs?start_date=2026-05-01&end_date=2026-05-08&scope=self&group_by%5B%5D=model%2Capi_key&model_types%5B%5D=text%2Cimage&model_ids%5B%5D=deepseek-v3&api_key_ids%5B%5D=ak_abc123&limit=100&page=string" \
  -H "Authorization: Bearer "
```

--------------------------------

### Verify Atlas Cloud CLI Installation

Source: https://www.atlascloud.ai/docs/cli

Run this command after installation to verify that the Atlas Cloud CLI is installed correctly and accessible.

```bash
atlas version
```

--------------------------------

### Generate Video with Alibaba WAN 2.1 v2v 720p

Source: https://www.atlascloud.ai/docs/more-models/alibaba/wan-2.1-v2v-720p/generateVideo

Generates a video using the alibaba/wan-2.1/v2v-720p model. Requires an API key for authorization and specifies video source, prompt, and generation parameters.

```bash
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
  -H "Authorization: Bearer " \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-2.1/v2v-720p",
    "video": "https://static.atlascloud.ai/media/videos/1747052256991096593_W1ZWTPLH.mp4",
    "prompt": "In the heart of a bustling city square, a girl is dancing. The sun is setting, casting a warm golden hue over the cobblestone streets. Streetlights are beginning to flicker on, their soft glow mingling with the last rays of daylight. A gentle breeze carries the scent of freshly baked bread from a nearby bakery, mixing with the faint aroma of blooming flowers from the park across the way. The sounds of laughter and conversation fill the air, punctuated by the occasional honk of a distant car. The girl, with her hair flowing freely and a radiant smile on her face, moves gracefully to the rhythm of an invisible melody, her joyous spirit lifting the mood of everyone around her."
  }'
```

```json
{
  "id": "string",
  "urls": {},
  "model": "string",
  "status": "string",
  "outputs": [
    "string"
  ],
  "created_at": "2019-08-24T14:15:22Z",
  "has_nsfw_contents": [
    true
  ]
}
```

--------------------------------

### Generate Video with Alibaba Wan 2.1

Source: https://www.atlascloud.ai/docs/more-models/alibaba/wan-2.1-v2v-720p-lora-ultra-fast/generateVideo

Generates a video using the alibaba/wan-2.1/v2v-720p-lora-ultra-fast model. Requires an API key for authorization.

```bash
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
  -H "Authorization: Bearer " \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-2.1/v2v-720p-lora-ultra-fast",
    "video": "https://static.atlascloud.ai/media/videos/1747054235924170377_ljxByuqm.mp4",
    "prompt": "flat color, no lineart, A woman races up the staircase as rain pours down outside at night."
  }'
```

--------------------------------

### Install Atlas Cloud CLI with Homebrew

Source: https://www.atlascloud.ai/docs/cli

Use this command to install the Atlas Cloud CLI via Homebrew. The installed command will be `atlas`.

```bash
brew install AtlasCloudAI/tap/atlascloud
```

--------------------------------

### Generate Video with Alibaba WAN 2.2 i2v 720p Ultra Fast

Source: https://www.atlascloud.ai/docs/more-models/alibaba/wan-2.2-i2v-720p-ultra-fast/generateVideo

Use this endpoint to generate video with the alibaba/wan-2.2/i2v-720p-ultra-fast model. Ensure you have a valid API key for authorization.

```curl
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
  -H "Authorization: Bearer " \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-2.2/i2v-720p-ultra-fast",
    "image": "string",
    "prompt": "string"
  }'
```

--------------------------------

### Install Atlas Cloud CLI with Windows PowerShell

Source: https://www.atlascloud.ai/docs/cli

Use this command to install the Atlas Cloud CLI on Windows via PowerShell. It downloads, verifies, and installs `atlas.exe`.

```powershell
irm https://raw.githubusercontent.com/AtlasCloudAI/cli/main/install.ps1 | iex
```

--------------------------------

### Install Atlas Cloud CLI with macOS/Linux Shell Installer

Source: https://www.atlascloud.ai/docs/cli

Install the Atlas Cloud CLI on macOS or Linux using this shell script. Manual downloads are available on GitHub Releases.

```bash
curl -fsSL https://raw.githubusercontent.com/AtlasCloudAI/cli/main/install.sh | sh
```

--------------------------------

### Generate Video with Alibaba Wan 2.1

Source: https://www.atlascloud.ai/docs/more-models/alibaba/wan-2.1-t2v-480p-lora-ultra-fast/generateVideo

Generates a video using the alibaba/wan-2.1/t2v-480p-lora-ultra-fast model. Requires an API key for authorization.

```bash
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
  -H "Authorization: Bearer " \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-2.1/t2v-480p-lora-ultra-fast",
    "prompt": "The video shows a [z00m_ca11] with four participants. In the top left box, a medieval knight in full armor adjusts his helmet. To his right, a pirate with a parrot on his shoulder. In the bottom left, a scientist in a lab coat scribbles on a whiteboard. In the bottom right, an alien in a suit waves awkwardly"
  }'
```

--------------------------------

### Install Atlas Cloud Skills using Shell Script

Source: https://www.atlascloud.ai/docs/skills

Execute this shell script to install Atlas Cloud Skills.

```bash
curl -fsSL https://raw.githubusercontent.com/AtlasCloudAI/atlas-cloud-skills/main/install.sh | sh
```

--------------------------------

### Generate Video with alibaba/wan-2.1-14b-vace

Source: https://www.atlascloud.ai/docs/more-models/alibaba/wan-2.1-14b-vace/generateVideo

Generates a video using the alibaba/wan-2.1-14b-vace model. Requires an API key for authorization. The request body includes parameters like model, prompt, and optional settings for seed, size, task, and more.

```bash
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
  -H "Content-Type: application/json" \
  -d '{ 
    "model": "alibaba/wan-2.1-14b-vace", 
    "prompt": "The elegant lady carefully selects bags in the boutique, and she shows the charm of a mature woman in a black slim dress with a pearl necklace, as well as her pretty face. Holding a vintage-inspired blue leather half-moon handbag, she is carefully observing its craftsmanship and texture. The interior of the store is a haven of sophistication and luxury. Soft, ambient lighting casts a warm glow over the polished wooden floors" 
  }'
```

--------------------------------

### Install Atlas Cloud Skills using npx

Source: https://www.atlascloud.ai/docs/skills

Use this command for a quick and recommended installation of Atlas Cloud Skills.

```bash
npx skills add AtlasCloudAI/atlas-cloud-skills
```

--------------------------------

### Complete Python Example for Image-to-Video Generation

Source: https://www.atlascloud.ai/docs/tutorials/image-to-video

This Python script demonstrates the full workflow for generating a video from an image using the Atlas Cloud API. It includes functions for uploading media, initiating video generation, and waiting for the result. Ensure your ATLASCLOUD_API_KEY environment variable is set or replace 'your-api-key' with your actual key.

```python
import requests
import time
import os

API_KEY = os.environ.get("ATLASCLOUD_API_KEY", "your-api-key")
BASE_URL = "https://api.atlascloud.ai/api/v1"

def upload_image(file_path):
    """Upload a local image and get a temporary URL."""
    with open(file_path, "rb") as f:
        response = requests.post(
            f"{BASE_URL}/model/uploadMedia",
            headers={"Authorization": f"Bearer {API_KEY}"},
            files={"file": f}
        )
    response.raise_for_status()
    url = response.json().get("url")
    print(f"Uploaded: {url}")
    return url

def generate_video(image_url, prompt, model="kling-v2.0"):
    """Submit a video generation task from an image."""
    response = requests.post(
        f"{BASE_URL}/model/generateVideo",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "model": model,
            "prompt": prompt,
            "image_url": image_url
        }
    )
    response.raise_for_status()
    return response.json()["data"]["id"]

def wait_for_result(prediction_id, interval=5, timeout=300):
    """Poll for generation result with timeout."""
    elapsed = 0
    while elapsed < timeout:
        response = requests.get(
            f"{BASE_URL}/model/prediction/{prediction_id}",
            headers={"Authorization": f"Bearer {API_KEY}"}
        )
        result = response.json()
        status = result["data"]["status"]

        if status == "completed":
            return result["data"]["outputs"][0]
        elif status == "failed":
            raise Exception(f"Failed: {result['data'].get('error')}")

        print(f"  Status: {status} ({elapsed}s)")
        time.sleep(interval)
        elapsed += interval

    raise TimeoutError("Generation timed out")

# Step 1: Upload source image
print("Step 1: Uploading image...")
image_url = upload_image("my_photo.jpg")

# Step 2: Generate video
prompt = "The person slowly turns their head and smiles, camera zooms in slightly"
print(f"Step 2: Generating video with prompt: {prompt}")
prediction_id = generate_video(image_url, prompt)
print(f"Task submitted: {prediction_id}")

# Step 3: Wait for result
print("Step 3: Waiting for video...")
video_url = wait_for_result(prediction_id)
print(f"Video ready: {video_url}")

```

--------------------------------

### Generate Video with Alibaba WAN 2.2 i2v 480p Ultra Fast

Source: https://www.atlascloud.ai/docs/more-models/alibaba/wan-2.2-i2v-480p-ultra-fast/generateVideo

Use this endpoint to generate a video using the alibaba/wan-2.2/i2v-480p-ultra-fast model. Ensure you include your Bearer token for authorization.

```curl
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
  -H "Authorization: Bearer " \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-2.2/i2v-480p-ultra-fast",
    "image": "string",
    "prompt": "string"
  }'
```

--------------------------------

### Image Generation Response Example

Source: https://www.atlascloud.ai/docs/more-models/black-forest-labs/flux-kontext-dev/generateImage

This is an example of a successful response when generating an image. It includes details about the request, model output, and status.

```json
{
  "id": "string",
  "logs": "string",
  "urls": {
    "cancel": "http://example.com",
    "result": "http://example.com"
  },
  "input": {
    "model": "black-forest-labs/flux-kontext-dev",
    "seed": -1,
    "size": "string",
    "image": "https://static.atlascloud.ai/media/images/1750940187685254815_W4yPaBQU.jpg",
    "prompt": "Change the car color to red.",
    "num_images": 1,
    "guidance_scale": 2.5,
    "num_inference_steps": 28,
    "enable_base64_output": false,
    "enable_safety_checker": true
  },
  "model": "string",
  "output": [
    "http://example.com"
  ],
  "status": "queued",
  "created_at": "2019-08-24T14:15:22Z",
  "has_nsfw_contents": [
    true
  ]
}
```

--------------------------------

### Node.js Example for Image-to-Video Generation

Source: https://www.atlascloud.ai/docs/models/video

This Node.js snippet shows how to create a video from an input image and a text prompt using the AtlasCloud AI API. You need to provide the image URL and a descriptive prompt.

```javascript
const atlascloud = require('atlascloud-sdk');

async function generateVideoFromImage(imageUrl, prompt) {
  const client = new atlascloud.Client({ apiKey: 'YOUR_API_KEY' });
  try {
    const video = await client.imageToVideo.generate({ imageUrl: imageUrl, prompt: prompt });
    console.log('Video generation initiated:', video.id);
    return video;
  } catch (error) {
    console.error('Error generating video:', error);
  }
}

generateVideoFromImage('https://example.com/image.jpg', 'A majestic dragon flying over mountains');
```

--------------------------------

### Generate Image API Response Example

Source: https://www.atlascloud.ai/docs/more-models/black-forest-labs/flux-kontext-dev-ultra-fast/generateImage

This is an example of a successful response when generating an image. It includes details about the request, generated output, and status.

```json
{
  "id": "string",
  "logs": "string",
  "urls": {
    "cancel": "http://example.com",
    "result": "http://example.com"
  },
  "input": {
    "model": "black-forest-labs/flux-kontext-dev-ultra-fast",
    "seed": -1,
    "size": "string",
    "image": "https://static.atlascloud.ai/media/images/1750941148466319080_zQWSOLIE.jpg",
    "prompt": "Replace 'KONTEXT' on the juice pouch, keeping the same bubbly font style,gradient colors, soft shadow, and exact position.",
    "num_images": 1,
    "guidance_scale": 2.5,
    "num_inference_steps": 28,
    "enable_base64_output": false,
    "enable_safety_checker": true
  },
  "model": "string",
  "output": [
    "http://example.com"
  ],
  "status": "queued",
  "created_at": "2019-08-24T14:15:22Z",
  "has_nsfw_contents": [
    true
  ]
}
```

--------------------------------

### Generate Video with Alibaba Wan 2.1

Source: https://www.atlascloud.ai/docs/more-models/alibaba/wan-2.1-t2v-720p-ultra-fast/generateVideo

Generates a video using the alibaba/wan-2.1/t2v-720p-ultra-fast model. Ensure you have a valid Bearer token for authorization.

```bash
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
  -H "Authorization: Bearer " \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-2.1/t2v-720p-ultra-fast",
    "prompt": "4K Mars colony panorama: Dome cities under dust storm, rover convoys with realistic tread marks, sci-fi realism"
  }'
```

--------------------------------

### Image Generation Response Example

Source: https://www.atlascloud.ai/docs/more-models/black-forest-labs/flux-dev-lora-ultra-fast/generateImage

This is an example of a successful response when generating an image. It includes details about the generated image, processing status, and input parameters.

```json
{
  "id": "7hm7nbwarxrm80cnq1yvmxz4m4",
  "logs": "...",
  "urls": {
    "cancel": "http://example.com",
    "result": "http://example.com"
  },
  "input": {
    "model": "black-forest-labs/flux-dev-lora-ultra-fast",
    "seed": -1,
    "size": "1024*1024",
    "image": "string",
    "loras": [
      {
        "path": "strangerzonehf/Flux-Super-Realism-LoRA",
        "scale": 1
      }
    ],
    "prompt": "Super Realism, High-resolution photograph, woman, UHD, photorealistic, shot on a Sony A7III --chaos 20 --ar 1:2 --style raw --stylize 250",
    "strength": 0.8,
    "mask_image": "string",
    "num_images": 1,
    "guidance_scale": 3.5,
    "num_inference_steps": 28,
    "enable_base64_output": false,
    "enable_safety_checker": true
  },
  "model": "black-forest-labs/flux-dev",
  "output": [
    "https://replicate.delivery/..."
  ],
  "status": "processing",
  "created_at": "2025-03-21T11:36:30.151Z",
  "has_nsfw_contents": [
    false
  ]
}
```

--------------------------------

### Node.js Example for Text-to-Video Generation

Source: https://www.atlascloud.ai/docs/models/video

This Node.js snippet demonstrates how to generate a video from a text prompt using the AtlasCloud AI API. Ensure you have the necessary SDK and API key configured.

```javascript
const atlascloud = require('atlascloud-sdk');

async function generateVideoFromText(prompt) {
  const client = new atlascloud.Client({ apiKey: 'YOUR_API_KEY' });
  try {
    const video = await client.textToVideo.generate({ prompt: prompt });
    console.log('Video generation initiated:', video.id);
    return video;
  } catch (error) {
    console.error('Error generating video:', error);
  }
}

generateVideoFromText('A futuristic cityscape at sunset');
```

--------------------------------

### Generate Video with Alibaba WAN Model (cURL)

Source: https://www.atlascloud.ai/docs/more-models/alibaba/wan-2.2-i2v-720p-lora-ultra-fast/generateVideo

Use this cURL command to generate a video with the alibaba/wan-2.2/i2v-720p-lora-ultra-fast model. Ensure you replace the placeholder token with your actual API key.

```bash
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
  -H "Authorization: Bearer " \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-2.2/i2v-720p-lora-ultra-fast",
    "image": "string",
    "prompt": "string"
  }'
```

--------------------------------

### Install Atlas Cloud CLI with npm

Source: https://www.atlascloud.ai/docs/cli

Install the Atlas Cloud CLI globally using npm. This package acts as a wrapper to download the appropriate binary.

```bash
npm install -g atlascloud-cli
```

--------------------------------

### Generate Video with alibaba/wan-2.2/i2v-720p

Source: https://www.atlascloud.ai/docs/more-models/alibaba/wan-2.2-i2v-720p/generateVideo

Generates a video using the alibaba/wan-2.2/i2v-720p model. Requires an API key for authorization.

```APIDOC
## POST /api/v1/model/generateVideo

### Description
Generates a video using the alibaba/wan-2.2/i2v-720p model.

### Method
POST

### Endpoint
https://api.atlascloud.ai/api/v1/model/generateVideo

### Parameters
#### Header Parameters
- **Authorization** (string) - Required - Bearer <token>

#### Request Body
- **model** (string) - Required - model name
- **seed** (integer) - Optional - The random seed to use for the generation. -1 means a random seed will be used. Default: -1
- **size** (string) - Optional - The size of the generated media in pixels (width*height). Value in "1280*720" | "720*1280"
- **image** (string) - Required - The image for generating the output.
- **prompt** (string) - Required - The prompt for generating the output.

### Request Example
```json
{
  "model": "alibaba/wan-2.2/i2v-720p",
  "image": "https://static.atlascloud.ai/media/images/1753542361521277039_dnDzwtqo.jpeg",
  "prompt": "A futuristic soldier activates a holographic map inside a high-tech command center, flickering lights, intense atmosphere"
}
```

### Response
#### Success Response (200)
- **id** (string) - Description
- **urls** (object) - Description
- **model** (string) - Description
- **status** (string) - Description
- **outputs** (array) - Description
- **created_at** (string) - Description
- **has_nsfw_contents** (array) - Description

#### Response Example
```json
{
  "id": "string",
  "urls": {},
  "model": "string",
  "status": "string",
  "outputs": [
    "string"
  ],
  "created_at": "2019-08-24T14:15:22Z",
  "has_nsfw_contents": [
    true
  ]
}
```
```

--------------------------------

### Generate Video Request (cURL)

Source: https://www.atlascloud.ai/docs/more-models/alibaba/wan-2.5-text-to-video-fast/generateVideo

Example cURL command to generate a video. Ensure to replace 'string' with your actual prompt and desired size. This example does not include authorization.

```shell
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
  -H "Content-Type: application/json" \
  -d '{ \
    "model": "alibaba/wan-2.5/text-to-video-fast", \
    "prompt": "string", \
    "size": "1280*720" \
  }'
```

--------------------------------

### Generate Video with alibaba/wan-2.1/v2v-720p

Source: https://www.atlascloud.ai/docs/more-models/alibaba/wan-2.1-v2v-720p/generateVideo

Generates a video using the alibaba/wan-2.1/v2v-720p model. Requires an API key for authorization.

```APIDOC
## POST /api/v1/model/generateVideo

### Description
Generates a video using the alibaba/wan-2.1/v2v-720p model.

### Method
POST

### Endpoint
/api/v1/model/generateVideo

### Parameters
#### Header Parameters
- **Authorization** (string) - Required - Bearer <token>

#### Request Body
- **model** (string) - Required - Model name (e.g., "alibaba/wan-2.1/v2v-720p")
- **video** (string) - Required - The video for generating the output.
- **prompt** (string) - Required - The prompt for generating the video.
- **seed** (integer) - Optional - The random seed to use for the generation. -1 means a random seed will be used. Default: -1
- **duration** (integer) - Optional - The duration of the generated media in seconds. Default: 5. Range: 5 <= value <= 10
- **strength** (number) - Optional - Default: 0.9. Range: 0.1 <= value <= 1
- **flow_shift** (number) - Optional - The shift value for the timestep schedule for flow matching. Default: 3. Range: 1 <= value <= 10
- **guidance_scale** (number) - Optional - The guidance scale to use for the generation. Default: 5. Range: 0 <= value <= 20
- **negative_prompt** (string) - Optional - The negative prompt for generating the output.
- **num_inference_steps** (integer) - Optional - The number of inference steps to perform. Default: 30. Range: 1 <= value <= 40
- **enable_safety_checker** (boolean) - Optional - If set to true, the safety checker will be enabled. Default: true

### Request Example
```json
{
  "model": "alibaba/wan-2.1/v2v-720p",
  "video": "https://static.atlascloud.ai/media/videos/1747052256991096593_W1ZWTPLH.mp4",
  "prompt": "In the heart of a bustling city square, a girl is dancing. The sun is setting, casting a warm golden hue over the cobblestone streets. Streetlights are beginning to flicker on, their soft glow mingling with the last rays of daylight. A gentle breeze carries the scent of freshly baked bread from a nearby bakery, mixing with the faint aroma of blooming flowers from the park across the way. The sounds of laughter and conversation fill the air, punctuated by the occasional honk of a distant car. The girl, with her hair flowing freely and a radiant smile on her face, moves gracefully to the rhythm of an invisible melody, her joyous spirit lifting the mood of everyone around her."
}
```

### Response
#### Success Response (200)
- **id** (string) - Description
- **urls** (object) - Description
- **model** (string) - Description
- **status** (string) - Description
- **outputs** (array of strings) - Description
- **created_at** (string) - Description
- **has_nsfw_contents** (array of booleans) - Description

#### Response Example
```json
{
  "id": "string",
  "urls": {},
  "model": "string",
  "status": "string",
  "outputs": [
    "string"
  ],
  "created_at": "2019-08-24T14:15:22Z",
  "has_nsfw_contents": [
    true
  ]
}
```
```

--------------------------------

### GET /model-costs

Source: https://www.atlascloud.ai/docs/public-api

Retrieves daily model cost buckets.

```APIDOC
## GET /model-costs

### Description
Retrieves daily model cost buckets. The default response returns total daily cost buckets.

### Method
GET

### Endpoint
/public/v1/model-costs

### Parameters
#### Query Parameters
- **start_date** (string) - Required - Inclusive UTC start date in `YYYY-MM-DD` format.
- **end_date** (string) - Required - Exclusive UTC end date in `YYYY-MM-DD` format; range can cover at most 180 days.
- **scope** (string) - Optional - `self` or `account`; defaults to `self`.
- **group_by[]** (string) - Optional - Supported sets: `model_type`, `model`, `api_key`, or `model` plus `api_key`; use `group_by[]=model` for model breakdown. Omitting `group_by[]` returns total daily buckets.
- **model_types[]** (string) - Optional - Repeat with `text`, `image`, or `video`.
- **model_ids[]** (string) - Optional - Filter by model IDs; up to 100 values.
- **api_key_ids[]** (string) - Optional - Filter by `ak_...` API key public IDs; up to 100 values.
- **limit** (integer) - Optional - Rows per page, 1 to 1000; defaults to 100.
- **page** (string) - Optional - Opaque pagination cursor from `next_page`.

### Request Example
```bash
curl "https://api.atlascloud.ai/public/v1/model-costs?start_date=2026-05-01&end_date=2026-05-08&scope=account&group_by[]=model&group_by[]=api_key" \
  -H "Authorization: Bearer apikey-..."
```

### Response
#### Success Response (200)
- **next_page** (string) - Opaque cursor for the next page of results.
- **has_more** (boolean) - Indicates if there are more pages of results.

*Response body schema depends on query parameters, especially `group_by[]`.*
```

--------------------------------

### GET /model-usage

Source: https://www.atlascloud.ai/docs/public-api

Retrieves daily model usage buckets.

```APIDOC
## GET /model-usage

### Description
Retrieves daily model usage buckets. The default response returns total daily usage buckets.

### Method
GET

### Endpoint
/public/v1/model-usage

### Parameters
#### Query Parameters
- **start_date** (string) - Required - Inclusive UTC start date in `YYYY-MM-DD` format.
- **end_date** (string) - Required - Exclusive UTC end date in `YYYY-MM-DD` format; range can cover at most 180 days.
- **scope** (string) - Optional - `self` or `account`; defaults to `self`.
- **group_by[]** (string) - Optional - Supported sets: `model_type`, `model`, `api_key`, or `model` plus `api_key`; use `group_by[]=model` for model breakdown. Omitting `group_by[]` returns total daily buckets.
- **model_types[]** (string) - Optional - Repeat with `text`, `image`, or `video`.
- **model_ids[]** (string) - Optional - Filter by model IDs; up to 100 values.
- **api_key_ids[]** (string) - Optional - Filter by `ak_...` API key public IDs; up to 100 values.
- **limit** (integer) - Optional - Rows per page, 1 to 1000; defaults to 100.
- **page** (string) - Optional - Opaque pagination cursor from `next_page`.

### Request Example
```bash
curl "https://api.atlascloud.ai/public/v1/model-usage?start_date=2026-05-01&end_date=2026-05-08" \
  -H "Authorization: Bearer apikey-..."
```

### Response
#### Success Response (200)
- **next_page** (string) - Opaque cursor for the next page of results.
- **has_more** (boolean) - Indicates if there are more pages of results.

*Response body schema depends on query parameters, especially `group_by[]`.*
```

--------------------------------

### Generate Video with minimax/hailuo-02/pro

Source: https://www.atlascloud.ai/docs/more-models/minimax/hailuo-02-pro/generateVideo

Generates a video using the minimax/hailuo-02/pro model. Requires an API key for authorization.

```APIDOC
## POST /api/v1/model/generateVideo

### Description
Generates a video using the minimax/hailuo-02/pro model.

### Method
POST

### Endpoint
https://api.atlascloud.ai/api/v1/model/generateVideo

### Parameters
#### Header Parameters
- **Authorization** (string) - Required - Bearer <token>
  API key is required to authorize requests. Obtain a key from your Atlas Cloud dashboard.

#### Request Body
application/json
- **model** (string) - Required - model name
- **image** (string) - Optional - The model generates video with the picture passed in as the first frame. Base64 encoded strings in data:image/jpeg; base64,{data} format for incoming images, or URLs accessible via the public network. The uploaded image needs to meet the following conditions: Format is JPG/JPEG/PNG; The aspect ratio is greater than 2:5 and less than 5:2; Short side pixels greater than 300px; The image file size cannot exceed 20MB.
- **prompt** (string) - Required - Generate a description of the video. (Note: Maximum support 2000 characters).
- **duration** (integer) - Optional - The duration of the generated media in seconds. Default: 6. Value in range [6, 2000].
- **enable_prompt_expansion** (boolean) - Optional - The model automatically optimizes incoming prompts to enhance output quality. This also activates the safety checker, which ensures content safety by detecting and filtering potential risks. Default: false.

### Request Example
```json
{
  "model": "minimax/hailuo-02/pro",
  "prompt": "astronaut in a yellow suit slowly walks through a futuristic airlock door, heading into deep space. Cinematic sci-fi atmosphere, smooth slow motion"
}
```

### Response
#### Success Response (200)
application/json
- **id** (string) - Description
- **urls** (object) - Description
- **model** (string) - Description
- **status** (string) - Description
- **outputs** (array) - Description
  - **items** (string)
- **created_at** (string) - Description (ISO 8601 format)
- **has_nsfw_contents** (array) - Description
  - **items** (boolean)

#### Response Example
```json
{
  "id": "string",
  "urls": {},
  "model": "string",
  "status": "string",
  "outputs": [
    "string"
  ],
  "created_at": "2019-08-24T14:15:22Z",
  "has_nsfw_contents": [
    true
  ]
}
```
```

--------------------------------

### Generate Video with alibaba/wan-2.1/i2v-720p

Source: https://www.atlascloud.ai/docs/more-models/alibaba/wan-2.1-i2v-720p/generateVideo

Generates a video using the alibaba/wan-2.1/i2v-720p model. Requires an API key for authorization and a JSON body with model details.

```curl
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
  -H "Authorization: Bearer " \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-2.1/i2v-720p",
    "image": "https://static.atlascloud.ai/media/images/1745147168756911752_14ZWSNLG.jpg",
    "prompt": "The family of three just took a selfie. They lean in together, smiling and relaxed. The daughter holds the phone and shows the screen. All three look at it with interest. They laugh softly, pointing at the photo. Their faces are close, full of warmth. The background is still the same scenic place. Candid, joyful, cinematic style"
  }'
```

```json
{
  "id": "7hm7nbwarxrm80cnq1yvmxz4m4",
  "logs": "...",
  "urls": {
    "cancel": "http://example.com",
    "result": "http://example.com"
  },
  "input": {
    "model": "alibaba/wan-2.1/i2v-720p",
    "seed": -1,
    "size": "1280*720",
    "image": "https://static.atlascloud.ai/media/images/1745147168756911752_14ZWSNLG.jpg",
    "prompt": "The family of three just took a selfie. They lean in together, smiling and relaxed. The daughter holds the phone and shows the screen. All three look at it with interest. They laugh softly, pointing at the photo. Their faces are close, full of warmth. The background is still the same scenic place. Candid, joyful, cinematic style",
    "duration": 5,
    "flow_shift": 5,
    "guidance_scale": 5,
    "negative_prompt": "string",
    "num_inference_steps": 30,
    "enable_safety_checker": true,
    "enable_prompt_optimizer": false
  },
  "model": "black-forest-labs/flux-dev",
  "output": [
    "https://replicate.delivery/..."
  ],
  "status": "processing",
  "created_at": "2025-03-21T11:36:30.151Z",
  "has_nsfw_contents": [
    false
  ]
}
```

--------------------------------

### GET /balance

Source: https://www.atlascloud.ai/docs/public-api

Retrieves the current account balance and credit grant summary.

```APIDOC
## GET /balance

### Description
Retrieves the current account balance and credit grant summary.

### Method
GET

### Endpoint
/public/v1/balance

### Parameters
#### Query Parameters
- **scope** (string) - Optional - `self` or `account`; defaults to `self`. Requires account balance read permission.

### Request Example
```bash
curl "https://api.atlascloud.ai/public/v1/balance" \
  -H "Authorization: Bearer apikey-..."
```

### Response
#### Success Response (200)
- **value** (string) - The monetary value.
- **currency** (string) - The currency of the value.

#### Response Example
```json
{
  "value": "125.500000",
  "currency": "usd"
}
```
```

--------------------------------

### Get Generation Results API

Source: https://www.atlascloud.ai/docs/models/overview

Retrieves the results of an asynchronous generation task using its ID.

```APIDOC
## GET /api/v1/model/prediction/{id}

### Description
Fetches the results of an asynchronous generation task (image, video, etc.) using the provided task ID.

### Method
GET

### Endpoint
/api/v1/model/prediction/{id}

### Path Parameters
- **id** (string) - Required - The unique identifier of the generation task.

### Response
#### Success Response (200)
- **status** (string) - The current status of the task (e.g., `processing`, `completed`, `failed`).
- **result** (object or array) - The actual result of the generation. This can be a URL to an image/video, or other relevant data, depending on the task type. (Type varies based on task).

#### Response Example (for image generation)
```json
{
  "status": "completed",
  "result": {
    "image_url": "https://atlascloud.ai/results/generated-image-123.png"
  }
}
```

#### Response Example (for video generation)
```json
{
  "status": "completed",
  "result": {
    "video_url": "https://atlascloud.ai/results/generated-video-456.mp4"
  }
}
```
```

--------------------------------

### Generate Video with alibaba/wan-2.2/i2v-480p (cURL)

Source: https://www.atlascloud.ai/docs/more-models/alibaba/wan-2.2-i2v-480p/generateVideo

Use this cURL command to generate a video with the alibaba/wan-2.2/i2v-480p model. Ensure you replace the placeholder with your actual Bearer token.

```bash
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
  -H "Authorization: Bearer " \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-2.2/i2v-480p",
    "image": "https://static.atlascloud.ai/media/images/1753541824086577593_sdmhea6s.jpeg",
    "prompt": "A mysterious woman in a flowing red dress walks slowly through a neon-lit alley at night, rain falling, cinematic lighting, slow-motion"
  }'
```

--------------------------------

### Generate Video from Text Prompt (Node.js)

Source: https://www.atlascloud.ai/docs/models/video

This Node.js example demonstrates how to submit a video generation request using the fetch API. Ensure your API key is correctly formatted in the Authorization header.

```javascript
const response = await fetch(
  "https://api.atlascloud.ai/api/v1/model/generateVideo",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer your-api-key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "kling-v2.0",
      prompt: "A beautiful timelapse of clouds moving over a mountain range",
    }),
  }
);

const predictionId = (await response.json()).data.id;
console.log(`Task submitted. Prediction ID: ${predictionId}`);
```

--------------------------------

### Video Generation Response (JSON)

Source: https://www.atlascloud.ai/docs/more-models/alibaba/wan-2.5-text-to-video/generateVideo

Example JSON response structure for a successful video generation request.

```json
{
  "created_at": "2019-08-24T14:15:22Z",
  "has_nsfw_contents": [
    true
  ],
  "id": "string",
  "model": "string",
  "outputs": [
    {}
  ],
  "status": "string",
  "urls": {}
}
```

--------------------------------

### Media Upload API

Source: https://www.atlascloud.ai/docs/models/get-start

Upload local files to get temporary URLs for use in generation tasks.

```APIDOC
## POST /api/v1/model/uploadMedia

### Description
Uploads a local file to obtain a temporary URL.

### Method
POST

### Endpoint
`https://api.atlascloud.ai/api/v1/model/uploadMedia`

### Parameters
#### Request Body
- **file** (file) - Required - The local file to upload.

### Request Example
```json
{
  "file": "photo.jpg"
}
```

### Success Response (200)
- **url** (string) - The temporary URL of the uploaded file.

### Response Example
```json
{
  "url": "https://cdn.atlascloud.ai/temp/some_file_id.jpg"
}
```
```

--------------------------------

### Generate Video with alibaba/wan-2.1/t2v-720p

Source: https://www.atlascloud.ai/docs/more-models/alibaba/wan-2.1-t2v-720p/generateVideo

Generates a video using the alibaba/wan-2.1/t2v-720p model. Requires an API key for authorization.

```APIDOC
## POST /api/v1/model/generateVideo

### Description
Generates a video using the alibaba/wan-2.1/t2v-720p model.

### Method
POST

### Endpoint
https://api.atlascloud.ai/api/v1/model/generateVideo

### Parameters
#### Header Parameters
- **Authorization** (string) - Required - Bearer <token>

#### Request Body
- **model** (string) - Required - model name
- **prompt** (string) - Required - The prompt for generating the output.
- **seed** (integer) - Optional - The random seed to use for the generation. -1 means a random seed will be used. Default: -1
- **size** (string) - Optional - The size of the generated media in pixels (width*height). Value in "1280*720" | "720*1280"
- **duration** (integer) - Optional - The duration of the generated media in seconds. Default: 5. Range: 5 <= value <= 10
- **flow_shift** (number) - Optional - The shift value for the timestep schedule for flow matching. Default: 5. Range: 1 <= value <= 10
- **guidance_scale** (number) - Optional - The guidance scale to use for the generation. Default: 5. Range: 0 <= value <= 20
- **negative_prompt** (string) - Optional - The negative prompt for generating the output.
- **num_inference_steps** (integer) - Optional - The number of inference steps to perform. Default: 30. Range: 1 <= value <= 40
- **enable_safety_checker** (boolean) - Optional - If set to true, the safety checker will be enabled. Default: true

### Request Example
```json
{
  "model": "alibaba/wan-2.1/t2v-720p",
  "prompt": "A rugged male secret agent in a torn tactical suit sprints through a war-torn urban alley, pistol in one hand, a bleeding gash on his brow. His eyes are sharp and calculating, sweat glistening on his tense face. Explosions light up the background as he dives into cover in slow motion"
}
```

### Response
#### Success Response (200)
- **id** (string) - Description
- **urls** (object) - Description
- **model** (string) - Description
- **status** (string) - Description
- **outputs** (array) - Description
- **created_at** (string) - Description
- **has_nsfw_contents** (array) - Description

#### Response Example
```json
{
  "id": "string",
  "urls": {},
  "model": "string",
  "status": "string",
  "outputs": [
    "string"
  ],
  "created_at": "2019-08-24T14:15:22Z",
  "has_nsfw_contents": [
    true
  ]
}
```
```