# ai& API ドキュメント

Source: https://aiand-docs-staging.pages.dev/ja/

## 概要

ai& はオープンウェイトの LLM を自社インフラ上でホストし、OpenAI / Anthropic 互換 API でアクセスできるサービスです。既存の SDK のベース URL を ai& に向けるだけで、コードを変更せずに当社がホストするオープンソースモデルを利用できます。課金はトークン単位のクレジット制です。

## ベース URL

```
https://api.aiand.com
```

すべての API エンドポイントはこのベース URL から提供されます。すべてのリクエストには認証が必要です。

## 最初のリクエスト

<Tabs syncKey="lang">
<TabItem label="curl">

```bash
curl https://api.aiand.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemma-4-31b-it",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
```

</TabItem>
<TabItem label="Python">

```python
from openai import OpenAI

client = OpenAI(base_url="https://api.aiand.com/v1", api_key="sk-...")

response = client.chat.completions.create(
    model="google/gemma-4-31b-it",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)
```

</TabItem>
<TabItem label="Node.js">

```ts
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.aiand.com/v1",
  apiKey: "sk-...",
});

const response = await client.chat.completions.create({
  model: "google/gemma-4-31b-it",
  messages: [{ role: "user", content: "Hello!" }],
});
console.log(response.choices[0].message.content);
```

</TabItem>
</Tabs>

## 提供する機能

<CardGrid>
  <Card title="OpenAI 互換" icon="rocket">
    `/v1/chat/completions` のドロップイン代替として利用できます。
    OpenAI SDK、LangChain、LlamaIndex など、OpenAI 形式に対応するあらゆるツールで動作します。
  </Card>
  <Card title="オープンソースモデル" icon="random">
    1 つの API キーでオープンソースモデルにアクセスできます。
    どのモデルでも同じ OpenAI 互換のリクエスト形式が使えます。
  </Card>
  <Card title="マルチモーダル入力" icon="puzzle">
    画像や動画を [Files API](/ja/api/files/) で一度アップロードし、チャット補完では `file_id` で参照できます。
    OpenAI 標準のワイヤーフォーマットなので、純正の SDK がそのまま動作します。
  </Card>
  <Card title="クレジット課金" icon="approve-check-circle">
    トークン単位の従量課金で、クレジットから自動的に消費されます。
    モデルごとの価格設定 — 使った分だけお支払いいただきます。失敗したリクエストには課金されません。
  </Card>
</CardGrid>

## 次のステップ

<CardGrid>
  <LinkCard title="クイックスタート" href="/ja/getting-started/" description="ゼロから最初の API コールまで 5 分で。" />
  <LinkCard title="モデルカタログ" href="/ja/models/catalog/" description="オープンウェイトモデル一覧 — 価格・capability・コンテキストウィンドウ。" />
  <LinkCard title="チャット補完" href="/ja/api/chat-completions/" description="エンドポイントリファレンス — リクエスト / レスポンス形式。" />
  <LinkCard title="OpenAI からの移行" href="/ja/migrating-openai/" description="2 行の設定変更で既存の OpenAI コードを ai& に向ける。" />
</CardGrid>

## AI エージェント向け

このドキュメントは [llms.txt 規約](https://llmstxt.org/)に沿ったプレーンテキストのコーパスとして公開しています。
エージェントはクロールせずに全体を読み込めます。

<CardGrid>
  <LinkCard title="llms.txt" href="/ja/llms.txt" description="全ページの索引。1 行につき 1 ページの説明付きリンク。" />
  <LinkCard title="llms-full.txt" href="/ja/llms-full.txt" description="ドキュメント全文を 1 つのテキストファイルにまとめたもの。" />
</CardGrid>
