> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 汎用グラフィックインターフェース

## インターフェースの説明

開発者がさまざまな画像生成モデルを呼び出しやすくするために、Aihubmixは統一されたグラフィックインターフェースを提供し、以下の主要なモデルをサポートしています。

* [OpenAI シリーズ](#openai)
* [Ideogram V3](#ideogram-v3)
* [Stability SD 3.5 Large](#stability)
* [Google Imagen シリーズ](#google-imagen)

**インターフェース仕様：**

```shell Curl theme={null}
curl https://aihubmix.com/v1/models/<model_path>/predictions \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer sk-***" \
    -d '{
  "input": {
    "prompt": "your prompt"
  }
}'
```

**内訳：**

* `https://aihubmix.com/v1/models/` は固定プレフィックスです
* `<model_path>` はモデルパスで、以下をサポートします。
  * `openai/gpt-image-2`
  * `opanai/gpt-image-1`
  * `opanai/dall-e-3`
  * `imagen-4.0-ultra-generate-001`
  * `imagen-4.0-generate-001`
  * `imagen-4.0-fast-generate-001`
  * `imagen-4.0-fast-generate-preview-06-06`
  * `imagen-3.0-generate-002`
  * `flux-kontext-max`
  * `flux-kontext-pro`
  * `FLUX.1-Kontext-pro`
  * `FLUX-1.1-pro`
  * `ideogram/V3`
  * `stability/Stable-Diffusion-3-5-Large`
* `sk-***` はAihubmixで生成したAPIキーです

***

以下は各モデルの呼び出し方法です。

## OpenAI

### サポートされているモデル：

* [gpt-image-2](https://aihubmix.com/model/gpt-image-2)（OpenAI互換の画像編集エンドポイントで利用できます。モデルIDは `gpt-image-2` と記述し、`image2` は使用しません）
* gpt-image-1
* dall-e-3

### 呼び出し方法：

<CodeGroup>
  ```shell Curl gpt-image-1 theme={null}
  curl https://aihubmix.com/v1/models/opanai/gpt-image-1/predictions \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer sk-***" \
      -d '{
    "input": {
      "prompt": "湖で水を飲む鹿、桜の花びらが舞い落ちる、緑と澄んだ水、日本の寺、木漏れ日、映画のような照明、広大な景色、平和",
      "size": "1024x1024", 
      "n": 1,
      "quality": "high",
      "moderation": "low",
      "background": "auto"
    }
  }'
  ```

  ```shell Curl dall-e-3 theme={null}
  curl https://aihubmix.com/v1/models/opanai/dall-e-3/predictions \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer sk-***" \
      -d '{
    "input": {
      "prompt": "湖で水を飲む鹿、桜の花びらが舞い落ちる、緑と澄んだ水、日本の寺、木漏れ日、映画のような照明、広大な景色、平和",
      "size": "1024x1024", 
      "n": 1
    }
  }'
  ```
</CodeGroup>

### gpt-image-2

これはOpenAIの画像編集モデルです。呼び出し時は完全なモデル名 `gpt-image-2` を指定してください。`image2` は有効なモデルIDではありません。エンドポイントが `b64_json` を返す場合、以下の例では `edited.png` として保存します。

<CodeGroup>
  ```powershell PowerShell theme={null}
  curl.exe -sS -X POST "https://aihubmix.com/v1/images/edits" `
    -H "Authorization: Bearer YOUR_API_KEY" `
    -F "model=gpt-image-2" `
    -F "prompt=背景を青空と白い雲に変更する" `
    -F "image=@test.png" `
    -F "size=1024x1024" `
    -D headers.txt `
    -o response.json `
    -w "HTTP_CODE:%{http_code}`nTOTAL:%{time_total}`n"

  $b64 = (Get-Content .\response.json -Raw | ConvertFrom-Json).data[0].b64_json
  [IO.File]::WriteAllBytes(".\edited.png", [Convert]::FromBase64String($b64))
  ```

  ```typescript TypeScript theme={null}
  import { readFile, writeFile } from "node:fs/promises";

  const apiKey = process.env.AIHUBMIX_API_KEY;
  if (!apiKey) {
    throw new Error("Set AIHUBMIX_API_KEY first.");
  }

  const form = new FormData();
  form.append("model", "gpt-image-2");
  form.append("prompt", "背景を青空と白い雲に変更する");
  form.append("image", new Blob([await readFile("test.png")], { type: "image/png" }), "test.png");
  form.append("size", "1024x1024");

  const response = await fetch("https://aihubmix.com/v1/images/edits", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${apiKey}`,
    },
    body: form,
  });

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

  const result = (await response.json()) as {
    data: Array<{ b64_json: string }>;
  };

  await writeFile("edited.png", Buffer.from(result.data[0].b64_json, "base64"));
  ```
</CodeGroup>

## Ideogram V3

### サポートされているモデル：

* V3

<Note>
  1. V3以下のバージョン（V\_2、V\_1など）は古いインターフェースであり、現在サポートされていません
  2. 返されるリンクはプロキシネットワークを介してアクセスする必要があります
</Note>

### 呼び出し方法：

<CodeGroup>
  ```shell Curl theme={null}
  curl https://aihubmix.com/v1/models/ideogram/V3/predictions \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer sk-***" \
      -d '{
    "input": {
      "prompt": "湖で水を飲む鹿、桜の花びらが舞い落ちる、緑と澄んだ水、日本の寺、木漏れ日、映画のような照明、広大な景色、平和、ピクサー3Dスタイル",
      "rendering_speed": "QUALITY",
      "aspect_ratio": "2x1"
    }
  }'
  ```
</CodeGroup>

## Stability

### サポートされているモデル：

* Stable-Diffusion-3-5-Large

### 呼び出し方法：

<CodeGroup>
  ```shell Curl theme={null}
  curl https://aihubmix.com/v1/models/stability/Stable-Diffusion-3-5-Large/predictions \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer sk-***" \
      -d '{
    "input": {
      "prompt": "湖で水を飲む鹿、桜の花びらが舞い落ちる、緑と澄んだ水、日本の寺、木漏れ日、映画のような照明、広大な景色、平和",
      "n": 1
    }
  }'
  ```
</CodeGroup>

## Google Imagen

### サポートされているモデル：

* imagen-4.0-ultra-generate-001
* imagen-4.0-generate-001
* imagen-4.0-fast-generate-001
* imagen-4.0-fast-generate-preview-06-06
* imagen-3.0-generate-002

<Note>
  Geminiシリーズはサポートされていません
</Note>

### 呼び出し方法：

<CodeGroup>
  ```shell Curl theme={null}
  curl https://aihubmix.com/v1/models/google/imagen-3.0-generate-002/predictions \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer sk-***" \
      -d '{
    "input": {
      "prompt": "A deer drinking in the lake, Sakura petals falling, green and clean water, japanese temple, dappled sunlight, cinematic lighting, expansive view, peace",
      "numberOfImages": 1
    }
  }'
  ```
</CodeGroup>

***

最終更新日：2026-06-01