APIリファレンス

https://api.airouter.dmm.com/v1

curl https://api.airouter.dmm.com/v1/chat/completions \
  -H "Authorization: Bearer $AIROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "google/gemini-2.5-flash", "messages": [{"role": "user", "content": "Hello!"}]}'

POST /v1/chat/completions HTTP/1.1
Host: api.airouter.dmm.com
Authorization: Bearer sk-air-...
Content-Type: application/json

curl https://api.airouter.dmm.com/v1/models \
  -H "Authorization: Bearer $AIROUTER_API_KEY"

curl https://api.airouter.dmm.com/v1/models \
  -H "Authorization: Bearer $AIROUTER_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "google/gemini-2.5-flash",
      "object": "model",
      "created": 1759363200,
      "owned_by": "google"
    },
    {
      "id": "deepseek/deepseek-v4-pro",
      "object": "model",
      "created": 1759363200,
      "owned_by": "deepseek"
    }
  ]
}

curl https://api.airouter.dmm.com/v1/chat/completions \
  -H "Authorization: Bearer $AIROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-2.5-flash",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ]
  }'

{
  "id": "01K72W3M9Q4ZJ8N2T6VY5XH0RB",
  "object": "chat.completion",
  "created": 1759968000,
  "model": "google/gemini-2.5-flash",
  "provider": "edensoft",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you today?",
        "refusal": null
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 17,
    "completion_tokens": 9,
    "total_tokens": 26
  }
}

curl https://api.airouter.dmm.com/v1/chat/completions \
  -H "Authorization: Bearer $AIROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-2.5-flash",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": true
  }'

data: {"id":"01K72W3M9Q4ZJ8N2T6VY5XH0RB","object":"chat.completion.chunk","created":1759968000,"model":"google/gemini-2.5-flash","provider":"edensoft","choices":[{"index":0,"delta":{"role":"assistant","content":""},"finish_reason":null}]}

data: {"id":"01K72W3M9Q4ZJ8N2T6VY5XH0RB","object":"chat.completion.chunk","created":1759968000,"model":"google/gemini-2.5-flash","provider":"edensoft","choices":[{"index":0,"delta":{"content":"Hello"},"finish_reason":null}]}

data: {"id":"01K72W3M9Q4ZJ8N2T6VY5XH0RB","object":"chat.completion.chunk","created":1759968000,"model":"google/gemini-2.5-flash","provider":"edensoft","choices":[{"index":0,"delta":{"content":"! How can I help you today?"},"finish_reason":"stop"}]}

data: {"id":"01K72W3M9Q4ZJ8N2T6VY5XH0RB","object":"chat.completion.chunk","created":1759968000,"model":"google/gemini-2.5-flash","provider":"edensoft","choices":[{"index":0,"delta":{},"finish_reason":null}],"usage":{"prompt_tokens":17,"completion_tokens":9,"total_tokens":26}}

data: [DONE]

{
  "id": "01K72W3M9Q4ZJ8N2T6VY5XH0RB",
  "object": "chat.completion.chunk",
  "created": 1759968000,
  "model": "google/gemini-2.5-flash",
  "provider": "edensoft",
  "choices": [
    {
      "index": 0,
      "delta": {"content": "Hello"},
      "finish_reason": null
    }
  ]
}

curl https://api.airouter.dmm.com/v1/chat/completions \
  -H "Authorization: Bearer $AIROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-2.5-flash",
    "messages": [{"role": "user", "content": "What is the weather in Tokyo?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get the current weather for a city.",
        "parameters": {
          "type": "object",
          "properties": {
            "city": {"type": "string", "description": "City name"}
          },
          "required": ["city"]
        }
      }
    }],
    "tool_choice": "auto"
  }'

{
  "id": "01K72W3M9Q4ZJ8N2T6VY5XH0RB",
  "object": "chat.completion",
  "created": 1759968000,
  "model": "google/gemini-2.5-flash",
  "provider": "edensoft",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": null,
        "refusal": null,
        "tool_calls": [
          {
            "id": "call_7Yq3",
            "type": "function",
            "function": {
              "name": "get_weather",
              "arguments": "{\"city\": \"Tokyo\"}"
            }
          }
        ]
      },
      "finish_reason": "tool_calls"
    }
  ],
  "usage": {
    "prompt_tokens": 58,
    "completion_tokens": 14,
    "total_tokens": 72
  }
}

curl https://api.airouter.dmm.com/v1/chat/completions \
  -H "Authorization: Bearer $AIROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-2.5-flash",
    "messages": [
      {"role": "user", "content": "What is the weather in Tokyo?"},
      {
        "role": "assistant",
        "content": null,
        "tool_calls": [
          {
            "id": "call_7Yq3",
            "type": "function",
            "function": {"name": "get_weather", "arguments": "{\"city\": \"Tokyo\"}"}
          }
        ]
      },
      {
        "role": "tool",
        "tool_call_id": "call_7Yq3",
        "content": "{\"temperature_c\": 24, \"condition\": \"sunny\"}"
      }
    ],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get the current weather for a city.",
        "parameters": {
          "type": "object",
          "properties": {
            "city": {"type": "string", "description": "City name"}
          },
          "required": ["city"]
        }
      }
    }]
  }'

calls = {}
for chunk in stream:
    choice = chunk.choices[0]
    for part in choice.delta.tool_calls or []:
        call = calls.setdefault(part.index, {"id": None, "name": None, "arguments": ""})
        if part.id:
            call["id"] = part.id
        if part.function and part.function.name:
            call["name"] = part.function.name
        if part.function and part.function.arguments:
            call["arguments"] += part.function.arguments
    if choice.finish_reason == "tool_calls":
        break
# calls[index]["arguments"] is now a complete JSON string

curl https://api.airouter.dmm.com/v1/chat/completions \
  -H "Authorization: Bearer $AIROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-2.5-flash",
    "messages": [
      {"role": "system", "content": "Extract the event details."},
      {"role": "user", "content": "Team lunch on Friday at 12:30 in Shibuya."}
    ],
    "response_format": {
      "type": "json_schema",
      "json_schema": {
        "name": "event",
        "schema": {
          "type": "object",
          "properties": {
            "title": {"type": "string"},
            "day": {"type": "string"},
            "time": {"type": "string"},
            "location": {"type": "string"}
          },
          "required": ["title", "day", "time", "location"],
          "additionalProperties": false
        },
        "strict": true
      }
    }
  }'

{
  "role": "assistant",
  "content": "{\"title\":\"Team lunch\",\"day\":\"Friday\",\"time\":\"12:30\",\"location\":\"Shibuya\"}",
  "refusal": null
}

{
  "model": "google/gemini-2.5-flash",
  "messages": [
    {"role": "system", "content": "Answer in JSON with keys \"answer\" and \"confidence\"."},
    {"role": "user", "content": "What is the capital of Japan?"}
  ],
  "response_format": {"type": "json_object"}
}

{
  "error": {
    "message": "This model does not support JSON output.",
    "code": "unsupported_parameter",
    "param": "response_format"
  }
}

HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=utf-8
x-request-id: 01K72W3M9Q4ZJ8N2T6VY5XH0RB

{
  "error": {
    "message": "messages[1].role: role must be one of system, user, assistant or tool.",
    "code": "validation_failed",
    "param": "messages[1].role"
  }
}

data: {"id":"01K72W3M9Q4ZJ8N2T6VY5XH0RB","object":"chat.completion.chunk","created":1759968000,"model":"google/gemini-2.5-flash","provider":"edensoft","choices":[{"index":0,"delta":{"content":"Hello"},"finish_reason":null}]}

data: {"id":"01K72W3M9Q4ZJ8N2T6VY5XH0RB","object":"chat.completion.chunk","created":1759968000,"model":"google/gemini-2.5-flash","provider":"edensoft","choices":[{"index":0,"delta":{},"finish_reason":"error"}],"error":{"message":"An unexpected error occurred. Please try again later.","code":"internal_error","param":null}}

data: [DONE]