API teks dan chat

Gunakan dokumentasi model teks CometAPI dengan mencocokkan format permintaan Anda ke halaman yang mengimplementasikannya. Untuk chat yang kompatibel dengan OpenAI, mulai dengan Chat Completions atau Responses; untuk format native penyedia, gunakan halaman penyedia yang sesuai.

Pilih API teks dan chat

Buat chat completion

Kirim pesan chat yang kompatibel dengan OpenAI dengan array messages.

Buat respons model

Gunakan reasoning, output multimodal, dan tools bawaan melalui API Responses.

Buat Message

Panggil alur kerja Messages yang kompatibel dengan Claude dengan field native penyedia.

Hasilkan konten

Kirim permintaan pembuatan konten native Gemini.

Panggil model teks

Gunakan model ID apa pun yang mendukung teks dari halaman Models atau direktori model. Contoh di bawah ini memanggil endpoint Chat Completions yang kompatibel dengan OpenAI.

Contoh-contoh ini menggunakan placeholder your-model-id. Ganti dengan model ID teks yang tersedia dari halaman Models atau direktori model sebelum Anda menjalankan permintaan.

import os
import requests

response = requests.post(
    "https://api.cometapi.com/v1/chat/completions",
    headers={
        "Authorization": "Bearer " + os.environ["COMETAPI_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "model": "your-model-id",
        "messages": [
            {
                "role": "user",
                "content": "Write one sentence about CometAPI.",
            }
        ],
    },
    timeout=30,
)

response.raise_for_status()
result = response.json()
print(result["choices"][0]["message"]["content"])

const response = await fetch("https://api.cometapi.com/v1/chat/completions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "your-model-id",
    messages: [
      {
        role: "user",
        content: "Write one sentence about CometAPI.",
      },
    ],
  }),
});

if (!response.ok) {
  throw new Error(await response.text());
}

const result = await response.json();
console.log(result.choices[0].message.content);

curl https://api.cometapi.com/v1/chat/completions \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "messages": [
      {
        "role": "user",
        "content": "Write one sentence about CometAPI."
      }
    ]
  }'

Contoh respons

Respons yang berhasil dapat terlihat seperti ini. Nilai field bervariasi menurut model dan permintaan:

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1779960520,
  "model": "your-model-id",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "CometAPI lets developers route model requests through one API surface."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 14,
    "total_tokens": 26
  }
}

Contoh rekaman model

Respons katalog model contoh ini menunjukkan envelope /api/models dan bentuk satu rekaman model teks. Ini bukan daftar model yang lengkap.

cURL

curl https://api.cometapi.com/api/models

{
  "success": true,
  "page": 1,
  "page_size": 20,
  "total": 302,
  "data": [
    {
      "created": 1773798949,
      "id": "your-text-model-id",
      "code": "your-text-model-id",
      "provider": "ExampleProvider",
      "provider_code": "example",
      "name": "Example text model",
      "model_type": "text",
      "features": [
        "text-to-text"
      ],
      "endpoints": "{\n  \"openai-chat\": {\n    \"path\": \"/v1/chat/completions\",\n    \"method\": \"POST\"\n  }\n}",
      "pricing": {
        "currency": "USD / M Tokens",
        "input": 0.5,
        "output": 1.5,
        "per_request": null,
        "per_second": null
      }
    }
  ]
}

Kesalahan umum

API key hilang atau tidak valid

Kirim Authorization: Bearer $COMETAPI_KEY.

Base URL salah

Gunakan https://api.cometapi.com/v1 untuk permintaan yang kompatibel dengan OpenAI.

Jenis model salah

Pilih model yang mendukung teks dari halaman Models.

Kesalahan parameter khusus provider

Hapus field opsional, lalu tambahkan kembali field tersebut satu per satu.

Kode error dan strategi retry

400

Jangan retry sampai body permintaan diperbaiki.

401

Jangan retry sampai API key tersedia dan valid.

404

Periksa base URL, path, dan model ID sebelum retry.

429

Retry dengan exponential backoff dan kurangi concurrency.

500 or 503

Retry dengan backoff untuk kesalahan provider atau layanan yang bersifat sementara.

Untuk pola implementasi, lihat Kode error dan strategi retry dan Rate limits dan concurrency.

Harga dan direktori model

Halaman Models

Baca bagaimana CometAPI menampilkan model ID di dokumentasi.

Direktori model

Jelajahi ketersediaan dan kapabilitas model.

Harga

Periksa harga sebelum Anda memanggil model.

Moderasi konten

Kunci API

Pilih API teks dan chat

Buat chat completion

Buat respons model

Buat Message

Hasilkan konten

Panggil model teks

Contoh respons

Contoh rekaman model

Kesalahan umum

Kode error dan strategi retry

Harga dan direktori model

Halaman Models

Direktori model

Harga

​Pilih API teks dan chat

Buat chat completion

Buat respons model

Buat Message

Hasilkan konten

​Panggil model teks

​Contoh respons

​Contoh rekaman model

​Kesalahan umum

​Kode error dan strategi retry

​Harga dan direktori model

Halaman Models

Direktori model

Harga

Pilih API teks dan chat

Panggil model teks

Contoh respons

Contoh rekaman model

Kesalahan umum

Kode error dan strategi retry

Harga dan direktori model