API Key

API key digunakan untuk mengautentikasi permintaan Anda ke API Atlas Cloud. Setiap panggilan API memerlukan API key yang valid.

Buat API Key

1. Buka API Keys
2. Klik Buat API Key
3. Salin API key baru Anda dan simpan dengan aman

API key Anda hanya akan ditampilkan sekali saat dibuat. Jika Anda kehilangannya, Anda perlu membuat yang baru.

Menggunakan API Key Anda

Sertakan API key Anda di header Authorization setiap permintaan API:

Authorization: Bearer your-api-key

LLM / Chat Completions (Kompatibel dengan OpenAI)

Base URL: https://api.atlascloud.ai/v1

from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://api.atlascloud.ai/v1"
)

response = client.chat.completions.create(
    model="deepseek-v3",
    messages=[{"role": "user", "content": "Hello!"}]
)

Pembuatan Gambar / Video

Base URL: https://api.atlascloud.ai/api/v1

import requests

response = requests.post(
    "https://api.atlascloud.ai/api/v1/model/generateImage",
    headers={"Authorization": "Bearer your-api-key"},
    json={
        "model": "seedream-3.0",
        "prompt": "A cat sitting on a rainbow"
    }
)

Upload Media

import requests

response = requests.post(
    "https://api.atlascloud.ai/api/v1/model/uploadMedia",
    headers={"Authorization": "Bearer your-api-key"},
    files={"file": open("photo.jpg", "rb")}
)

# Mengembalikan URL sementara untuk digunakan dengan tugas pembuatan
print(response.json())

Integrasi Alat Pihak Ketiga

Anda dapat menggunakan API key Atlas Cloud dengan alat atau aplikasi kompatibel OpenAI apa pun. Opsi populer meliputi:

Saat mengonfigurasi alat pihak ketiga:

• API Host / Base URL: https://api.atlascloud.ai/v1 (akhiran /v1 wajib)
• API Key: API key Atlas Cloud Anda
• Nama Model: Model apa pun dari Perpustakaan Model

Praktik Terbaik Keamanan

• Jangan pernah membagikan API key Anda atau memasukkannya ke kontrol versi
• Gunakan variabel lingkungan untuk menyimpan API key Anda:

  export ATLASCLOUD_API_KEY="your-api-key"

• Rotasi key secara berkala — hapus key lama dan buat yang baru
• Gunakan key terpisah untuk lingkungan development dan production
• Pantau penggunaan di Konsol untuk mendeteksi penggunaan tidak sah

Manajemen Key

Anda dapat mengelola API key di Pengaturan Akun:

• Buat — Hasilkan API key baru sesuai kebutuhan
• Hapus — Cabut API key yang tidak lagi diperlukan atau mungkin telah dikompromikan
• Lihat penggunaan — Pantau penggunaan API dan biaya yang terkait dengan setiap key

Batas Rate

Batas rate API bervariasi berdasarkan tingkat akun dan jenis model. Jika Anda menemukan error batas rate (429 Too Many Requests), pertimbangkan:

• Menambahkan delay kecil antar permintaan
• Menggunakan exponential backoff untuk percobaan ulang
• Menghubungi [email protected] untuk batas yang lebih tinggi