--- title: Bir API anahtarı oluşturun | RunAPI description: Standart bir API anahtarı oluşturun. Bu işlem tarafından döndürülen düz metin anahtarı kaydedin; anahtar yalnızca bir kez gösterilir. url: https://runapi.ai/tr/docs/api/management/keys/create.md canonical: https://runapi.ai/tr/docs/api/management/keys/create locale: tr --- > HTML sürümü: https://runapi.ai/tr/docs/api/management/keys/create > Ajanlar için site dizini: https://runapi.ai/llms.txt # Bir API anahtarı oluşturun Standart bir API anahtarı oluşturun. Bu işlem tarafından döndürülen düz metin anahtarı kaydedin; anahtar yalnızca bir kez gösterilir. ## Uç Nokta POST /api/v1/keys Temel URL: https://runapi.ai API sürümü: v1 Kimlik doğrulama: Authorization: Bearer YOUR_MANAGEMENT_API_KEY Yetkilendirme: Hesap yöneticisi Yönetim API anahtarı gerektirir. Yeni Standart API anahtarı çağırıcıya aittir. ## İstek Değerleri yalnızca listelenen istek konumunda gönderin. ### JSON gövdesi ```json { "allowed_models": { "description": "İsteğe bağlı model tanımlayıcıları izin listesi.", "required": false, "type": "array | null" }, "credit_limit_cents": { "description": "USD sent cinsinden isteğe bağlı harcama tavanı.", "required": false, "type": "integer | null" }, "credit_limit_reset_interval": { "description": "Anahtar harcama tavanı için isteğe bağlı sıfırlama periyodu.", "enum": [ "daily", "weekly", "monthly" ], "required": false, "type": "string | null" }, "credit_limit_windows": { "description": "1h, 1d veya 7d anahtarlarıyla belirtilen dönen harcama limitleri; her değer pozitif bir tamsayı limit_cents içerir.", "required": false, "type": "object" }, "enabled": { "default": true, "description": "Bu anahtarı kullanan isteklerin kabul edilip edilmediği.", "required": false, "type": "boolean" }, "guardrail_id": { "description": "Oluşturma sırasında eklenecek isteğe bağlı koruyucu ön ek kimliği.", "required": false, "type": "string" }, "name": { "description": "API anahtarı için kolay okunur ad.", "required": false, "type": "string" } } ``` ## Başarılı yanıt HTTP 201 - POST /api/v1/keys ```json { "allowed_models": [ "gpt-5.4" ], "created_at": "2026-07-27T10:00:00.000Z", "credit_limit_cents": 1000, "credit_limit_reset_interval": "daily", "credit_limit_windows": { "1d": { "limit_cents": 500 }, "1h": { "limit_cents": 100 }, "7d": { "limit_cents": 2000 } }, "enabled": true, "guardrail_id": "guardrail_123", "id": "token_123", "key": "runapi_plaintext_example", "last_used_at": null, "masked_token": "runapi_abc...wxyz", "name": "Production" } ``` ## Hata yanıtı (401) HTTP 401 ### Yanıt şeması ```json { "properties": { "error": { "description": "İnsan tarafından okunabilir hata mesajı.", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### Yanıt örneği ```json { "error": "Authentication required" } ``` ## Hata yanıtı (403) HTTP 403 ### Yanıt şeması ```json { "properties": { "error": { "description": "İnsan tarafından okunabilir hata mesajı.", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### Yanıt örneği ```json { "error": "Management API key required" } ``` ## Hata yanıtı (403) HTTP 403 ### Yanıt şeması ```json { "properties": { "error": { "description": "İnsan tarafından okunabilir hata mesajı.", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### Yanıt örneği ```json { "error": "Account admin required" } ``` ## Hata yanıtı (400) HTTP 400 ### Yanıt şeması ```json { "oneOf": [ { "properties": { "error": { "description": "İnsan tarafından okunabilir hata mesajı.", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false }, { "properties": { "error": { "description": "İnsan tarafından okunabilir doğrulama özeti.", "type": "string" }, "errors": { "additionalProperties": { "items": { "type": "string" }, "type": "array" }, "description": "Herkese açık istek alanına göre anahtarlanan doğrulama mesajları; her alan için insan tarafından okunabilir dizelerden oluşan bir dizi içerir.", "type": "object" } }, "required": [ "error", "errors" ], "type": "object", "unevaluatedProperties": false } ] } ``` ### Yanıt örneği ```json { "error": "page must be an integer" } ``` ## Hata yanıtı (422) HTTP 422 ### Yanıt şeması ```json { "properties": { "error": { "description": "İnsan tarafından okunabilir doğrulama özeti.", "type": "string" }, "errors": { "additionalProperties": { "items": { "type": "string" }, "type": "array" }, "description": "Herkese açık istek alanına göre anahtarlanan doğrulama mesajları; her alan için insan tarafından okunabilir dizelerden oluşan bir dizi içerir.", "type": "object" } }, "required": [ "error", "errors" ], "type": "object", "unevaluatedProperties": false } ``` ### Yanıt örneği ```json { "error": "Validation failed", "errors": { "base": [ "Validation failed" ] } } ``` ## cURL örneği ### curl ```curl curl -X POST https://runapi.ai/api/v1/keys \ -H 'Authorization: Bearer YOUR_MANAGEMENT_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"name":"Production","credit_limit_cents":1000,"credit_limit_reset_interval":"daily","credit_limit_windows":{"1h":{"limit_cents":100},"1d":{"limit_cents":500},"7d":{"limit_cents":2000}},"allowed_models":["gpt-5.4"],"guardrail_id":"guardrail_123"}' ``` ## İlgili başvuru - [API Anahtarları](https://runapi.ai/tr/docs/api/management/keys.md) - [API Anahtarı nesnesi](https://runapi.ai/tr/docs/api/management/keys/object.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": "Bir API anahtarı oluşturun", "description": "Standart bir API anahtarı oluşturun. Bu işlem tarafından döndürülen düz metin anahtarı kaydedin; anahtar yalnızca bir kez gösterilir.", "url": "https://runapi.ai/tr/docs/api/management/keys/create", "mainEntityOfPage": "https://runapi.ai/tr/docs/api/management/keys/create" } ] ```