株式会社アルテレクト

APIドキュメント

ATRAS APIのエンドポイント、認証方式、レートリミット、コードサンプル。

ATRAS API

v1 | RESTful | OpenAI互換

ATRAS APIは、チャット、エージェント実行、ナレッジベース検索など、全サービスをプログラムから利用するための統合APIです。OpenAI互換のインターフェースを提供し、既存のコードベースからの移行も容易です。

認証方式

API Key認証

Authorizationヘッダーにベアラートークンとして送信。最も簡単な認証方法です。

Authorization: Bearer sk-xxxxxxxxxxxx

OAuth 2.0

エンタープライズ向け。SSO連携とスコープベースのアクセス制御を提供します。

Grant Type: authorization_code

主要エンドポイント

POST/v1/chat/completions

チャット形式のテキスト生成。ストリーミング対応。

modelmessagestemperaturestream

POST/v1/agents/run

AIエージェントの実行。タスク分解と自律実行をサポート。

agent_idtaskcontexttools

POST/v1/knowledge/search

ナレッジベースの意味検索。ハイブリッド検索対応。

knowledge_base_idquerytop_kfilters

GET/v1/models

利用可能なモデルの一覧取得。

コードサンプル

example.ts

import { AtrasClient } from '@arterect/sdk'

const client = new AtrasClient({
  apiKey: process.env.ATRAS_API_KEY,
})

// チャット完了
const response = await client.chat.completions.create({
  model: 'atras-gpt-4o',
  messages: [
    { role: 'system', content: 'あなたは優秀なAIアシスタントです。' },
    { role: 'user', content: 'AGIとは何ですか？' },
  ],
  stream: true,
})

for await (const chunk of response) {
  process.stdout.write(chunk.choices[0]?.delta?.content || '')
}

レートリミット

プラン	リクエスト上限	トークン上限	モデルアクセス
Free	60 req/min	100K tokens/day	基本モデルのみ
Pro	600 req/min	2M tokens/day	全モデル
Enterprise	カスタム	無制限	全モデル + 専用インスタンス

このAPIドキュメントはデモンストレーション用です。表示されているエンドポイントや仕様はサンプルデータです。