# Responses

> POST /v1/responses, format OpenAI Responses, dipakai Codex dan OpenClaw.

```http
POST https://api.vikey.ai/v1/responses
```

Format sama dengan [Responses API OpenAI](https://platform.openai.com/docs/api-reference/responses). Codex dan OpenClaw (dengan `openai-responses`) memakai endpoint ini. Semua model teks di Vikey bisa dipanggil lewat format ini.

## Contoh

```bash
curl https://api.vikey.ai/v1/responses \
  -H "Authorization: Bearer API_KEY_KAMU" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6.1-sol",
    "instructions": "Jawab singkat dalam bahasa Indonesia.",
    "input": "Apa beda let dan const di JavaScript?"
  }'
```

## Parameter yang sering dipakai

| Parameter | Keterangan |
| --- | --- |
| `model` | Wajib. Model id Vikey. |
| `input` | Wajib. Teks, atau array item pesan dan hasil tool. |
| `instructions` | Instruksi sistem. |
| `max_output_tokens` | Batas token output. |
| `stream` | `true` untuk event stream format Responses. |
| `tools` | Function tools. |

## Response

```json
{
  "id": "resp_...",
  "object": "response",
  "model": "openai/gpt-6.1-sol",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [{"type": "output_text", "text": "let bisa diubah nilainya, const tidak..."}]
    }
  ],
  "usage": {"input_tokens": 30, "output_tokens": 55, "total_tokens": 85}
}
```

Source: https://docs.vikey.ai/api/responses/