promptfoo--promptfoo/site/docs/providers/atlascloud.md

sidebar_label, description

sidebar_label	description
Atlas Cloud	Access Atlas Cloud's OpenAI-compatible LLM API to evaluate models from DeepSeek, Qwen, Kimi, GLM, and more through promptfoo

Atlas Cloud

Atlas Cloud is an AI API aggregation platform that provides unified access to 300+ AI models through one API key and billing account. Its LLM chat API is OpenAI-compatible, so it integrates with promptfoo using the same request shape as the OpenAI chat provider.

Setup

1. Create an API key in the Atlas Cloud dashboard.
2. Set the ATLASCLOUD_API_KEY environment variable:

export ATLASCLOUD_API_KEY=your_api_key_here

You can also pass apiKey directly in the provider config, but using an environment variable is recommended.

Basic Configuration

# yaml-language-server: $schema=https://promptfoo.dev/config-schema.json
providers:
  - id: atlascloud:deepseek-ai/DeepSeek-V3-0324
    config:
      temperature: 0.7
      max_tokens: 500

  - id: atlascloud:qwen/qwen3-32b
    config:
      temperature: 0.2

prompts:
  - 'Answer clearly and concisely: {{question}}'

tests:
  - vars:
      question: 'What is the capital of France?'
    assert:
      - type: contains
        value: 'Paris'

By default, the Atlas Cloud provider sends chat requests to https://api.atlascloud.ai/v1.

Configuration Options

Atlas Cloud supports the standard OpenAI chat options already available in promptfoo, including:

• temperature
• max_tokens
• top_p
• presence_penalty
• frequency_penalty
• stop
• response_format
• tools
• tool_choice

For the full shared option set, see the OpenAI provider documentation.

Custom Base URL or API Key Variable

If you route Atlas Cloud through a proxy or internal gateway, override apiBaseUrl. You can also instruct promptfoo to read the Bearer token from a different environment variable by setting apiKeyEnvar.

providers:
  - id: atlascloud:deepseek-ai/DeepSeek-V3-0324
    config:
      apiBaseUrl: https://proxy.example.com/atlas/v1
      apiKeyEnvar: MY_ATLASCLOUD_TOKEN
      temperature: 0.7

Precedence is:

• config.apiBaseUrl if provided, otherwise Atlas Cloud's default https://api.atlascloud.ai/v1
• config.apiKeyEnvar if provided, otherwise ATLASCLOUD_API_KEY

Model Examples

Atlas Cloud's catalog changes over time. You should use the exact model ID returned by GET /v1/models. For example, this provider was verified against live Atlas Cloud model IDs such as deepseek-ai/DeepSeek-V3-0324 and qwen/qwen3-32b.

providers:
  - atlascloud:deepseek-ai/DeepSeek-V3-0324
  - atlascloud:qwen/qwen3-32b
  - atlascloud:moonshotai/Kimi-K2-Instruct

Use the exact model ID shown in the Atlas Cloud model library or docs.

Example

See the runnable example in examples/provider-atlascloud.

Additional Resources

• Atlas Cloud Docs
• Atlas Cloud Get Started
• Atlas Cloud FAQ