Thông số phổ quát

Xác thực

Tất cả các điểm cuối đều yêu cầu khóa API Airforce. Tạo một cái trong bảng điều khiển bên dưới Khóa API. Chìa khóa bắt đầu bằng sk-air-.

Ví dụ

# Standard
curl https://api.airforce/v1/chat/completions \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  …

# Anthropic SDK style (only on /v1/messages, /v1/responses)
curl https://api.airforce/v1/messages \
  -H "x-api-key: sk-air-YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  …

# Multipart upload (file endpoints)
curl https://api.airforce/v1/audio/transcriptions \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  -F "[email protected]" \
  -F "model=whisper-1"

Tiêu đề yêu cầu tùy chọn

Tiêu đề phản hồi

Mức sử dụng và chi phí không được trả về dưới dạng các header tùy chỉnh X-*. Số lượng token được trả về trong đối tượng usage của phần thân phản hồi trên /v1/chat/completions và /v1/messages (các lần trúng prompt-cache của Anthropic cũng xuất hiện ở đó, ví dụ cache_read_input_tokens). Chi phí mỗi request được ghi lại trong nhật ký sử dụng trên dashboard của bạn, và các tác vụ media bất đồng bộ mang theo trường cost_cents trong phản hồi trạng thái của chúng.

Lý luận và suy nghĩ (điểm cuối)

Mô hình với supports_reasoning: true chấp nhận các tham số chuẩn giống nhau ở mọi nơi chúng xuất hiện (hiện tại /v1/chat/completions Và /v1/messages).

Nhìn thấy Hoàn thành trò chuyện → Lý do để biết ví dụ đầy đủ.

Quy ước phát trực tuyến

Điểm cuối chấp nhận stream: true đáp lại với Content-Type: text/event-stream và phát ra các Sự kiện do Máy chủ gửi. Định dạng dây phụ thuộc vào điểm cuối:

phong bì lỗi

Mọi phản hồi lỗi đều sử dụng cùng một hình dạng JSON. Mã trạng thái HTTP phản ánh loại lỗi.

{
  "error": {
    "message": "Model 'gpt-99' not found.",
    "type": "invalid_request",
    "param": "model",
    "code": "model_not_found"
  }
}

Giới hạn tỷ lệ và số lần thử lại

Các giới hạn được thực thi trên mỗi khóa API. Vượt quá bất kỳ lợi nhuận nào trong số đó 429:

• Per-second request throttle (plan-dependent).
• Daily token cap on free / pay-as-you-go plans.
• Hạn mức tín dụng cho mỗi khóa khi bạn đặt trong bảng điều khiển.
• Concurrent video tasks (typically 4 in flight).

Retry with exponential backoff on 429 and 503. Don't retry on 4xx other than 429.

sự bình thường

Điểm cuối thế hệ (trò chuyện, hình ảnh, âm thanh, video) không bình thường — mỗi cuộc gọi sẽ tạo ra phản hồi mới và được tính phí độc lập. Để có kết quả xác định, hãy đặt hạt giống cố định ở nơi được hỗ trợ (hình ảnh/âm thanh/một số mô hình trò chuyện). Điểm cuối không đồng bộ chạy dài (/v1/video/thế hệ) trả về task_id mà bạn có thể thăm dò lại một cách an toàn.

Bản đồ điểm cuối

Mọi điểm cuối công khai trong nháy mắt.