---
title: OpenAI Responses | RunAPI
description: RunAPI'nin OpenAI uyumlu Responses işlemi aracılığıyla bir istek gönderin.
url: https://runapi.ai/tr/docs/api/openai/responses.md
canonical: https://runapi.ai/tr/docs/api/openai/responses
locale: tr
---

> HTML sürümü: https://runapi.ai/tr/docs/api/openai/responses
> Ajanlar için site dizini: https://runapi.ai/llms.txt

# OpenAI Responses

## Genel Bakış

RunAPI'nin OpenAI uyumlu Responses işlemini, uyumlu bir model ve protokolün istek ile yanıt şekilleriyle kullanın.

### Hızlı başlangıç

1. Bir API anahtarı oluşturun ve RUNAPI_API_KEY olarak ayarlayın.
2. Uyumlu bir model seçin, ardından belgelenen yol parametrelerini ve JSON gövdesini gönderin.
3. Bu işlem için gösterilen JSON yanıtını veya sunucu tarafından gönderilen olayları okuyun ve protokol hatalarını işleyin.

## Uç Nokta

POST /v1/responses

Temel URL: https://runapi.ai

Sözleşme sürümü: v1

Tercih edilen kimlik doğrulama: Authorization: Bearer YOUR_API_TOKEN

## Kimlik doğrulama taşıyıcıları

RunAPI aşağıda listelenen her taşıyıcıyı kabul eder. Oluşturulan örnekler, protokolün tercih ettiği başlığı kullanır.

- `Authorization: Bearer YOUR_API_TOKEN` (Tercih edilen)
- `x-api-key: YOUR_API_TOKEN`
- `x-goog-api-key: YOUR_API_TOKEN`
- `?key=YOUR_API_TOKEN`

## Uyumlu modeller

Güncel fiyatlandırma, hız sınırları ve ticari kullanım ayrıntıları için bir model sayfası açın.

- [claude-fable-5-1](https://runapi.ai/tr/models/claude)
- [claude-fable-5](https://runapi.ai/tr/models/claude)
- [claude-sonnet-5](https://runapi.ai/tr/models/claude)
- [claude-opus-5](https://runapi.ai/tr/models/claude)
- [claude-opus-4-8](https://runapi.ai/tr/models/claude)
- [claude-opus-4-7](https://runapi.ai/tr/models/claude)
- [claude-opus-4-6](https://runapi.ai/tr/models/claude)
- [claude-sonnet-4-6](https://runapi.ai/tr/models/claude)
- [claude-opus-4-5-20251101](https://runapi.ai/tr/models/claude)
- [claude-sonnet-4-5-20250929](https://runapi.ai/tr/models/claude)
- [claude-haiku-4-5-20251001](https://runapi.ai/tr/models/claude)
- [claude-opus-4-1-20250805](https://runapi.ai/tr/models/claude)
- [gpt-5.5](https://runapi.ai/tr/models/gpt)
- [gpt-5.5-pro](https://runapi.ai/tr/models/gpt)
- [gpt-5.4](https://runapi.ai/tr/models/gpt)
- [gpt-5.4-mini](https://runapi.ai/tr/models/gpt)
- [gpt-5.4-nano](https://runapi.ai/tr/models/gpt)
- [gpt-5.4-pro](https://runapi.ai/tr/models/gpt)
- [gpt-5.3-codex](https://runapi.ai/tr/models/gpt)
- [gpt-5.3-codex-spark](https://runapi.ai/tr/models/gpt)
- [gpt-5.6-luna](https://runapi.ai/tr/models/gpt)
- [gpt-5.6-sol](https://runapi.ai/tr/models/gpt)
- [gpt-5.6-terra](https://runapi.ai/tr/models/gpt)
- [gpt-6-astra](https://runapi.ai/tr/models/gpt)
- [gemini-3.6-flash](https://runapi.ai/tr/models/gemini)
- [gemini-3.5-flash](https://runapi.ai/tr/models/gemini)
- [gemini-3.1-pro-preview](https://runapi.ai/tr/models/gemini)
- [gemini-3-flash-preview](https://runapi.ai/tr/models/gemini)
- [gemini-2.5-pro](https://runapi.ai/tr/models/gemini)
- [gemini-2.5-flash](https://runapi.ai/tr/models/gemini)
- [deepseek-v4-flash-vision-exp](https://runapi.ai/tr/models/deepseek)
- [deepseek-v4-pro](https://runapi.ai/tr/models/deepseek)
- [deepseek-v4-flash](https://runapi.ai/tr/models/deepseek)
- [glm-5.2](https://runapi.ai/tr/models/glm)
- [glm-5.1](https://runapi.ai/tr/models/glm)
- [glm-5-turbo](https://runapi.ai/tr/models/glm)
- [glm-5](https://runapi.ai/tr/models/glm)
- [glm-4.7](https://runapi.ai/tr/models/glm)
- [glm-4.6](https://runapi.ai/tr/models/glm)
- [glm-4.5](https://runapi.ai/tr/models/glm)
- [glm-4.5-air](https://runapi.ai/tr/models/glm)
- [kimi-k3](https://runapi.ai/tr/models/kimi)
- [kimi-k2.7-code](https://runapi.ai/tr/models/kimi)
- [kimi-k2.6](https://runapi.ai/tr/models/kimi)
- [kimi-k2.5](https://runapi.ai/tr/models/kimi)
- [MiniMax-M3](https://runapi.ai/tr/models/minimax)
- [MiniMax-M2.7](https://runapi.ai/tr/models/minimax)
- [MiniMax-M2.7-highspeed](https://runapi.ai/tr/models/minimax)
- [MiniMax-M2.5](https://runapi.ai/tr/models/minimax)
- [MiniMax-M2.5-highspeed](https://runapi.ai/tr/models/minimax)
- [MiniMax-M2.1](https://runapi.ai/tr/models/minimax)
- [MiniMax-M2](https://runapi.ai/tr/models/minimax)
- [mimo-v2.5-pro](https://runapi.ai/tr/models/mimo)
- [mimo-v2.5](https://runapi.ai/tr/models/mimo)
- [grok-4.20-0309-non-reasoning](https://runapi.ai/tr/models/grok)
- [grok-4.6](https://runapi.ai/tr/models/grok)
- [grok-4.5](https://runapi.ai/tr/models/grok)
- [grok-4.3](https://runapi.ai/tr/models/grok)

## İstek sözleşmesi

Yalnızca hem genel protokol hem de RunAPI destek kanıtı olan alanlar listelenmektedir. Ek JSON gövde alanları doğrudan iletilir.

### JSON gövdesi

Gerekli: `model`

```json
{
  "input": {
    "description": "Modele sağlanan metin, mesaj öğeleri veya araç sonuçları.",
    "type": [
      "string",
      "array"
    ]
  },
  "instructions": {
    "description": "Bu yanıt için sistem veya geliştirici talimatları.",
    "type": [
      "string",
      "null"
    ]
  },
  "max_output_tokens": {
    "description": "Görünür ve akıl yürütme belirteçleri dahil maksimum çıktı belirteci sayısı.",
    "type": [
      "integer",
      "null"
    ]
  },
  "model": {
    "description": "Uyumlu model kataloğu tarafından döndürülen RunAPI model tanımlayıcısı.",
    "type": "string"
  },
  "moderation": {
    "additionalProperties": true,
    "description": "Mevcut giriş ve tam çıktı için bağımsız moderasyon sinyallerini döndür.",
    "properties": {
      "model": {
        "enum": [
          "omni-moderation-latest"
        ],
        "type": "string"
      },
      "policy": {
        "additionalProperties": true,
        "properties": {
          "input": {
            "additionalProperties": true,
            "properties": {
              "mode": {
                "enum": [
                  "score",
                  "block"
                ],
                "type": "string"
              }
            },
            "required": [
              "mode"
            ],
            "type": [
              "object",
              "null"
            ]
          },
          "output": {
            "additionalProperties": true,
            "properties": {
              "mode": {
                "enum": [
                  "score",
                  "block"
                ],
                "type": "string"
              }
            },
            "required": [
              "mode"
            ],
            "type": [
              "object",
              "null"
            ]
          }
        },
        "type": [
          "object",
          "null"
        ]
      }
    },
    "required": [
      "model"
    ],
    "type": [
      "object",
      "null"
    ]
  },
  "stream": {
    "default": false,
    "description": "Yazılı Responses olaylarını sunucu tarafından gönderilen olaylar olarak döndür.",
    "type": [
      "boolean",
      "null"
    ]
  },
  "tools": {
    "description": "Modelin çağırabileceği araçlar.",
    "type": "array"
  }
}
```

### İstek örneği

```json
{
  "input": "Summarize one practical improvement for an API deployment.",
  "model": "gpt-5.4",
  "moderation": {
    "model": "omni-moderation-latest",
    "policy": {
      "input": {
        "mode": "score"
      },
      "output": {
        "mode": "block"
      }
    }
  }
}
```

## Eş zamanlı yanıt

HTTP 200

### Şema

```json
{
  "additionalProperties": true,
  "properties": {
    "id": {
      "type": "string"
    },
    "model": {
      "type": "string"
    },
    "moderation": {
      "additionalProperties": true,
      "properties": {
        "input": {
          "oneOf": [
            {
              "additionalProperties": true,
              "properties": {
                "categories": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "category_applied_input_types": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "category_scores": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "flagged": {
                  "type": "boolean"
                },
                "model": {
                  "const": "omni-moderation-latest",
                  "type": "string"
                },
                "type": {
                  "const": "moderation_result",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "model",
                "flagged",
                "categories",
                "category_scores",
                "category_applied_input_types"
              ],
              "type": "object"
            },
            {
              "additionalProperties": true,
              "properties": {
                "code": {
                  "type": "string"
                },
                "message": {
                  "type": "string"
                },
                "type": {
                  "const": "error",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "code",
                "message"
              ],
              "type": "object"
            }
          ]
        },
        "output": {
          "oneOf": [
            {
              "additionalProperties": true,
              "properties": {
                "categories": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "category_applied_input_types": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "category_scores": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "flagged": {
                  "type": "boolean"
                },
                "model": {
                  "const": "omni-moderation-latest",
                  "type": "string"
                },
                "type": {
                  "const": "moderation_result",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "model",
                "flagged",
                "categories",
                "category_scores",
                "category_applied_input_types"
              ],
              "type": "object"
            },
            {
              "additionalProperties": true,
              "properties": {
                "code": {
                  "type": "string"
                },
                "message": {
                  "type": "string"
                },
                "type": {
                  "const": "error",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "code",
                "message"
              ],
              "type": "object"
            }
          ]
        }
      },
      "required": [
        "input",
        "output"
      ],
      "type": "object"
    },
    "object": {
      "const": "response",
      "type": "string"
    },
    "output": {
      "type": "array"
    },
    "status": {
      "type": "string"
    },
    "usage": {
      "additionalProperties": true,
      "properties": {
        "input_tokens": {
          "type": "integer"
        },
        "output_tokens": {
          "type": "integer"
        },
        "total_tokens": {
          "type": "integer"
        }
      },
      "required": [
        "input_tokens",
        "output_tokens",
        "total_tokens"
      ],
      "type": "object"
    }
  },
  "required": [
    "id",
    "object",
    "status",
    "model",
    "output"
  ],
  "type": "object"
}
```

### Örnek

```json
{
  "id": "resp_example",
  "model": "gpt-5.4",
  "moderation": {
    "input": {
      "categories": {
        "sexual": false,
        "violence": true
      },
      "category_applied_input_types": {
        "sexual": [
          "text"
        ],
        "violence": [
          "text"
        ]
      },
      "category_scores": {
        "sexual": 0.0002,
        "violence": 0.96
      },
      "flagged": true,
      "model": "omni-moderation-latest",
      "type": "moderation_result"
    },
    "output": {
      "categories": {
        "sexual": false,
        "violence": false
      },
      "category_applied_input_types": {
        "sexual": [
          "text"
        ],
        "violence": [
          "text"
        ]
      },
      "category_scores": {
        "sexual": 0.0002,
        "violence": 0.0001
      },
      "flagged": false,
      "model": "omni-moderation-latest",
      "type": "moderation_result"
    }
  },
  "object": "response",
  "output": [
    {
      "content": [
        {
          "annotations": [],
          "text": "Hello! How can I help today?",
          "type": "output_text"
        }
      ],
      "id": "msg_example",
      "role": "assistant",
      "status": "completed",
      "type": "message"
    }
  ],
  "status": "completed",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 8,
    "total_tokens": 20
  }
}
```

## SSE olayı: output_text_delta

Medya türü: `text/event-stream`

### Şema

```json
{
  "additionalProperties": true,
  "properties": {
    "content_index": {
      "type": "integer"
    },
    "delta": {
      "type": "string"
    },
    "item_id": {
      "type": "string"
    },
    "output_index": {
      "type": "integer"
    },
    "type": {
      "const": "response.output_text.delta",
      "type": "string"
    }
  },
  "required": [
    "type",
    "item_id",
    "output_index",
    "content_index",
    "delta"
  ],
  "type": "object"
}
```

### Örnek

```json
{
  "content_index": 0,
  "delta": "Hello",
  "item_id": "msg_example",
  "output_index": 0,
  "type": "response.output_text.delta"
}
```

## SSE olayı: completed

Medya türü: `text/event-stream`

### Şema

```json
{
  "additionalProperties": true,
  "properties": {
    "response": {
      "additionalProperties": true,
      "properties": {
        "id": {
          "type": "string"
        },
        "model": {
          "type": "string"
        },
        "moderation": {
          "additionalProperties": true,
          "properties": {
            "input": {
              "oneOf": [
                {
                  "additionalProperties": true,
                  "properties": {
                    "categories": {
                      "additionalProperties": true,
                      "type": "object"
                    },
                    "category_applied_input_types": {
                      "additionalProperties": true,
                      "type": "object"
                    },
                    "category_scores": {
                      "additionalProperties": true,
                      "type": "object"
                    },
                    "flagged": {
                      "type": "boolean"
                    },
                    "model": {
                      "const": "omni-moderation-latest",
                      "type": "string"
                    },
                    "type": {
                      "const": "moderation_result",
                      "type": "string"
                    }
                  },
                  "required": [
                    "type",
                    "model",
                    "flagged",
                    "categories",
                    "category_scores",
                    "category_applied_input_types"
                  ],
                  "type": "object"
                },
                {
                  "additionalProperties": true,
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "type": {
                      "const": "error",
                      "type": "string"
                    }
                  },
                  "required": [
                    "type",
                    "code",
                    "message"
                  ],
                  "type": "object"
                }
              ]
            },
            "output": {
              "oneOf": [
                {
                  "additionalProperties": true,
                  "properties": {
                    "categories": {
                      "additionalProperties": true,
                      "type": "object"
                    },
                    "category_applied_input_types": {
                      "additionalProperties": true,
                      "type": "object"
                    },
                    "category_scores": {
                      "additionalProperties": true,
                      "type": "object"
                    },
                    "flagged": {
                      "type": "boolean"
                    },
                    "model": {
                      "const": "omni-moderation-latest",
                      "type": "string"
                    },
                    "type": {
                      "const": "moderation_result",
                      "type": "string"
                    }
                  },
                  "required": [
                    "type",
                    "model",
                    "flagged",
                    "categories",
                    "category_scores",
                    "category_applied_input_types"
                  ],
                  "type": "object"
                },
                {
                  "additionalProperties": true,
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "type": {
                      "const": "error",
                      "type": "string"
                    }
                  },
                  "required": [
                    "type",
                    "code",
                    "message"
                  ],
                  "type": "object"
                }
              ]
            }
          },
          "required": [
            "input",
            "output"
          ],
          "type": "object"
        },
        "object": {
          "const": "response",
          "type": "string"
        },
        "output": {
          "type": "array"
        },
        "status": {
          "type": "string"
        },
        "usage": {
          "additionalProperties": true,
          "properties": {
            "input_tokens": {
              "type": "integer"
            },
            "output_tokens": {
              "type": "integer"
            },
            "total_tokens": {
              "type": "integer"
            }
          },
          "required": [
            "input_tokens",
            "output_tokens",
            "total_tokens"
          ],
          "type": "object"
        }
      },
      "required": [
        "id",
        "object",
        "status",
        "model",
        "output",
        "usage"
      ],
      "type": "object"
    },
    "type": {
      "const": "response.completed",
      "type": "string"
    }
  },
  "required": [
    "type",
    "response"
  ],
  "type": "object"
}
```

### Örnek

```json
{
  "response": {
    "id": "resp_example",
    "model": "gpt-5.4",
    "moderation": {
      "input": {
        "categories": {
          "sexual": false,
          "violence": true
        },
        "category_applied_input_types": {
          "sexual": [
            "text"
          ],
          "violence": [
            "text"
          ]
        },
        "category_scores": {
          "sexual": 0.0002,
          "violence": 0.96
        },
        "flagged": true,
        "model": "omni-moderation-latest",
        "type": "moderation_result"
      },
      "output": {
        "categories": {
          "sexual": false,
          "violence": false
        },
        "category_applied_input_types": {
          "sexual": [
            "text"
          ],
          "violence": [
            "text"
          ]
        },
        "category_scores": {
          "sexual": 0.0002,
          "violence": 0.0001
        },
        "flagged": false,
        "model": "omni-moderation-latest",
        "type": "moderation_result"
      }
    },
    "object": "response",
    "output": [
      {
        "content": [
          {
            "annotations": [],
            "text": "Hello! How can I help today?",
            "type": "output_text"
          }
        ],
        "id": "msg_example",
        "role": "assistant",
        "status": "completed",
        "type": "message"
      }
    ],
    "status": "completed",
    "usage": {
      "input_tokens": 12,
      "output_tokens": 8,
      "total_tokens": 20
    }
  },
  "type": "response.completed"
}
```

## Protokol hatası: invalid_request

HTTP 400

### Şema

```json
{
  "additionalProperties": true,
  "properties": {
    "error": {
      "additionalProperties": true,
      "properties": {
        "code": {
          "type": [
            "string",
            "null"
          ]
        },
        "message": {
          "type": "string"
        },
        "param": {
          "type": [
            "string",
            "null"
          ]
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "message",
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "error"
  ],
  "type": "object"
}
```

### Örnek

```json
{
  "error": {
    "code": null,
    "message": "input must be a string or an array",
    "param": "input",
    "type": "invalid_request_error"
  }
}
```

## Kullanım

### Şema

```json
{
  "additionalProperties": true,
  "properties": {
    "input_tokens": {
      "type": "integer"
    },
    "output_tokens": {
      "type": "integer"
    },
    "total_tokens": {
      "type": "integer"
    }
  },
  "required": [
    "input_tokens",
    "output_tokens",
    "total_tokens"
  ],
  "type": "object"
}
```

### Örnek

```json
{
  "input_tokens": 12,
  "output_tokens": 8,
  "total_tokens": 20
}
```

## Oluşturulan Kod Örnekleri

Her cURL, JavaScript ve Python örneği, protokole özgü bir SDK gerektirmeden bu sözleşmedeki doğrulanmış isteği gönderir.

### curl

```curl
curl -X POST https://runapi.ai/v1/responses \
  -H Authorization:\ Bearer\ YOUR_API_TOKEN \
  -H Content-Type:\ application/json \
  -d \{\"model\":\"gpt-5.4\",\"input\":\"Summarize\ one\ practical\ improvement\ for\ an\ API\ deployment.\",\"moderation\":\{\"model\":\"omni-moderation-latest\",\"policy\":\{\"input\":\{\"mode\":\"score\"\},\"output\":\{\"mode\":\"block\"\}\}\}\}
```

### javascript

```javascript
const response = await fetch("https://runapi.ai/v1/responses", {
  method: "POST",
  headers: {
  "Authorization": "Bearer YOUR_API_TOKEN",
  "Content-Type": "application/json"
},
  body: JSON.stringify({
  "model": "gpt-5.4",
  "input": "Summarize one practical improvement for an API deployment.",
  "moderation": {
    "model": "omni-moderation-latest",
    "policy": {
      "input": {
        "mode": "score"
      },
      "output": {
        "mode": "block"
      }
    }
  }
})
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
console.log(data);
```

### python

#### Yükle

```bash
pip install requests
```

```python
import requests

response = requests.post(
    "https://runapi.ai/v1/responses",
    headers={"Authorization": "Bearer YOUR_API_TOKEN", "Content-Type": "application/json"},
    json={"model": "gpt-5.4", "input": "Summarize one practical improvement for an API deployment.", "moderation": {"model": "omni-moderation-latest", "policy": {"input": {"mode": "score"}, "output": {"mode": "block"}}}}
)
response.raise_for_status()
print(response.json())
```

## İlgili Kılavuzlar

- [Kimlik doğrulama](https://runapi.ai/tr/docs/guides/authentication.md)
- [Hızlı başlangıç](https://runapi.ai/tr/docs/guides/llm-api/quickstart.md)

---

## RunAPI hakkında daha fazlası

- [Ana sayfa](https://runapi.ai/tr/.md)
- [Model Kataloğu](https://runapi.ai/tr/models.md)
- [Fiyatlandırma](https://runapi.ai/tr/pricing.md)
- [Sağlayıcılar](https://runapi.ai/tr/models)
- [Dokümantasyon](https://runapi.ai/tr/docs/guides)
- [SDK'lar](https://runapi.ai/tr/sdk.md)
- [CLI](https://runapi.ai/tr/cli.md)
- [MCP Sunucusu](https://runapi.ai/tr/mcp.md)
- [Claude Code ve Cursor](https://runapi.ai/tr/claude-code-vs-cursor.md)
- [Cursor API kurulumu](https://runapi.ai/tr/cursor-api-setup.md)
- [RunAPI ve OpenRouter](https://runapi.ai/tr/openrouter-alternative.md)
- [Kurumsal](https://runapi.ai/tr/contact.md)
- [İletişim](https://runapi.ai/tr/contact.md)
- [Şartlar](https://runapi.ai/tr/terms.md)
- [Gizlilik](https://runapi.ai/tr/privacy.md)
- [Ajanlar için site dizini](https://runapi.ai/llms.txt)

İletişim: contact@runapi.ai

## Yapılandırılmış veriler

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "tr",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/tr",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/tr/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "tr",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/tr",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/tricon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "tr",
    "@type": "TechArticle",
    "headline": "OpenAI Responses",
    "description": "RunAPI'nin OpenAI uyumlu Responses işlemi aracılığıyla bir istek gönderin.",
    "url": "https://runapi.ai/tr/docs/api/openai/responses",
    "mainEntityOfPage": "https://runapi.ai/tr/docs/api/openai/responses"
  }
]
```