GPT-Live-1.1 API Nasıl Kullanılır?

GPT-Live-1.1 artık OpenAI API'de v1/live/sessions uç noktası üzerinden kullanılabilir. Bir WebSocket veya WebRTC oturumu açın, gpt-6-luna modeline Responses yetkilendirmesini yapılandırın, bir fonksiyon aracı ekleyin ve bu aracın çağırdığı arka ucu Apidog CLI ile test edin.

INEZA Felin-Michel

INEZA Felin-Michel

20 November 2026

GPT-Live-1.1 API Nasıl Kullanılır?

Kurumsal İçin Apidog

Şirket İçi (On-Premises) Dağıtım

SSO ve RBAC

SOC 2 Uyumlu

Apidog Enterprise'ı Keşfedin

GPT-Live-1.1 API, OpenAI’ın çift yönlü (full-duplex) ses modelidir ve v1/live/sessions üzerinden sunulur. WebRTC, WebSocket veya SIP üzerinden bir oturum açar, model, talimatlar ve sesi içeren bir session yapılandırması gönderir ve delegation (delegasyon) yoluyla akıl yürütme ile araç çağrılarını bir arka plan (backend) Responses modeline bırakırsınız. Maliyeti aktif dakika başına 0,05 $, bekleme dakikası başına 0,02 $’dır.

OpenAI, GPT-Live-1.1’i API’de 20 Kasım 2026’de kullanıma sundu; bkz. OpenAI Developers duyurusu. Temmuz kapsamımızı okuduysanız GPT-Live API var mı? yazısı “henüz yok” cevabını veriyordu. Bu değişti. Bu rehber size çalışan bir oturumu, bir delegasyon yapılandırmasını, bir fonksiyon aracını ve ses ajanınızın çağırdığı backend için bir test kurulumunu adım adım gösterir.

GPT-Live-1.1 API nedir?

GPT-Live-1.1, konuşurken dinleyen, ses alan ve ses döndüren bir modeldir. v1/realtime veya v1/responses üzerinde değil, v1/live/sessions uç noktasında çalışır. Asıl görevi konuşmayı yürütmektir. Daha ağır akıl yürütme ve araç kullanımı, yapılandırdığınız bir backend modeline devredilir; böylece iş yapılırken ses yanıt vermeye devam eder.

GPT-Live-1.1 model sayfasının bugün listeledikleri şunlar:

Öğe GPT-Live-1.1
Model kimliği gpt-live-1.1 (tek sürüm)
Giriş / çıkış Giriş ses ve metin, çıkış ses ve metin
Uç nokta Yalnızca v1/live/sessions
Taşıma katmanları WebRTC (önerilen), WebSocket, SIP
Aktif fiyat Dakika başına 0,05 $
Bekleme fiyatı Dakika başına 0,02 $ (WebRTC, çıkarım duraklatılmış)
Backend model ve araçlar Normal tarifelerine göre ayrı faturalandırılır
Eşzamanlılık GPT-Live-1’den ayrı limit, organizasyon başına

Ürün arka planı için GPT-Live nedir yazısına ve GPT Realtime ile farklarına göz atın.

GPT-Live-1.1 vs GPT-Live-1: ne değişti?

Model sayfası ve istemleme rehberi dört pratik fark listeliyor:

Her iki model de aynı uç noktayı, fiyatları ve oturum yapısını paylaştığı için 1.1’e geçmek çoğunlukla bir model dizesi değişikliği ve daha temiz bir istem anlamına gelir.

GPT-Live-1.1 oturumu nasıl açılır?

GPT-Live başlangıç rehberi, tarayıcı, mobil ve sunucu sesi için WebRTC’yi öneriyor. Sunucu taraflı bir prototip için WebSocket daha basit bir yol, o yüzden oradan başlayın:

  1. Authorization: Bearer $OPENAI_API_KEY başlığıyla, sorgu parametresi olmadan wss://api.openai.com/v1/live/sessions bağlantısını açın.
  2. İlk mesaj olarak, session yapılandırmanızla birlikte session.start gönderin.
  3. Ses göndermeden önce session.started mesajını bekleyin.
  4. Sesi seçtiğiniz formatta akıtın. Varsayılan 24 kHz PCM’dir.
import WebSocket from "ws";

const ws = new WebSocket("wss://api.openai.com/v1/live/sessions", {
  headers: { Authorization: `Bearer ${process.env.OPENAI_API_KEY}` },
});

ws.on("open", () => {
  ws.send(JSON.stringify({
    type: "session.start",
    event_id: "start_1",
    session: {
      model: "gpt-live-1.1",
      instructions: "You are the voice agent for Acme order support. Keep answers short.",
      audio: {
        format: { type: "audio/pcm", rate: 24000 },
        output: { voice: "marin" },
      },
    },
  }));
});

ws.on("message", (raw) => {
  const msg = JSON.parse(raw);
  if (msg.type === "session.started") console.log("Session ready");
});

Konuşma rehberinden birkaç yapılandırma kuralı:

Tarayıcıda üretim için WebRTC’ye geçin. API anahtarını sunucunuz tutar ve tarayıcının SDP teklifini aktarır:

const res = await fetch("https://api.openai.com/v1/live/sessions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.OPENAI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    session: { model: "gpt-live-1.1", instructions: "..." },
    transport: { type: "webrtc", sdp: offerSdp },
  }),
});
const { session, transport } = await res.json(); // HTTP 201
// session.id looks like "live_123"; return transport.sdp to the browser

WebRTC isteklerinde audio.format alanını çıkarmayın ve veri kanalında session.start göndermeyin. Dikkat edilmesi gereken bir faturalandırma detayı: bir WebRTC oturumu oluşturmak başlatma sırasında 15 saniye faturalandırır; bu süre, oturum çalışmaya başladığında iade edilir.

Architecture of a GPT-Live-1.1 app: the browser sends an SDP offer to your server, which calls POST /v1/live/sessions with the API key; audio flows over WebRTC between the browser and GPT-Live-1.1, which delegates to a gpt-6-luna backend that calls your tool API

GPT-Live-1.1 delegasyonu: akıl yürütmeyi bir backend modele bırakın

Delegasyon, bu API’nin var olma sebebidir. Ses modeli konuşmaya devam ederken bir backend model akıl yürütür, arama yapar veya araç çağırır. Oturum oluşturulurken iki moddan birini seçersiniz ve oturum ortasında mod değiştiremezsiniz.

Mod delegation.type Backend’i kim çalıştırır En uygun kullanım
Responses "responses" OpenAI, yapılandırdığınız model ve araçlarla Çoğu uygulama; barındırılan araçlar, fonksiyon çağırma
Client "client" (aynı zamanda varsayılan) Kendi uygulamanız Kendi ajan döngünüz veya OpenAI olmayan bir backend

Delegasyon rehberi, gpt-6-luna ile başlamayı ve daha zor backend görevleri için gpt-6-sol denemeyi öneriyor. Henüz seçim yapmadıysanız GPT-6 Luna genel bakış yazımız ödünleşimleri ele alıyor.

"delegation": {
  "type": "responses",
  "responses": {
    "model": "gpt-6-luna",
    "instructions": "Look up orders with get_order. Answer in one sentence.",
    "tools": [{ "type": "web_search" }],
    "tool_choice": "auto",
    "parallel_tool_calls": false
  }
}

responses bloğu ayrıca max_output_tokens (16 veya üzeri), service_tier (auto, default, flex veya priority; priority hızlı moddur) ve backend modelinizin desteklediği reasoning ile text ayarlarını da kabul eder. Bu alanları oturum sırasında session.update ile değiştirebilirsiniz. Doğrulama eşzamansızdır (asenkron): hatalı bir yapılandırma, responses_validation_failed kodlu bir error olarak gelir ve oturum açık kalır.

Ardından ses modeline ne zaman delege edeceğini söyleyin. 1.1 ile bu, instructions içinde düz dille yapılır:

Delegate to the backend when: the caller asks about an order, a refund or anything you must look up.
Do not delegate when: the caller greets you, asks you to repeat, or says goodbye.
While the backend works, briefly say what you are checking.

İstemleme rehberi, sesli bir “kontrol ediyorum” ifadesinin backend işinin başladığını kanıtlamadığına dikkat çeker. Bunun yerine günlüklerinizde session.delegation.created mesajını izleyin.

GPT-Live-1.1 oturumuna fonksiyon çağırma ekleme

Web araması gibi barındırılan araçlar OpenAI içinde çalışır. Kendi fonksiyonlarınız uygulamanızda çalışır. Standart bir Responses fonksiyon aracını delegation.responses.tools içine koyun:

{
  "type": "function",
  "name": "get_order",
  "description": "Get the shipping status of an order by its ID.",
  "parameters": {
    "type": "object",
    "properties": { "order_id": { "type": "string" } },
    "required": ["order_id"],
    "additionalProperties": false
  },
  "strict": true
}

Backend’in olayları, bir delegation_id ve iç içe bir event taşıyan response.event zarfı içinde size ulaşır. Tamamlanmış bir fonksiyon çağrısı, öğesinde call_id, name ve arguments bulunan iç içe bir response.output_item.done olarak gelir. Fonksiyonu çalıştırın, sonucu içeren bir response.item.create gönderin, ardından response.create gönderin:

ws.on("message", async (raw) => {
  const msg = JSON.parse(raw);
  if (msg.type !== "response.event") return;
  const ev = msg.event;
  if (ev.type !== "response.output_item.done" || ev.item?.type !== "function_call") return;

  const { order_id } = JSON.parse(ev.item.arguments);
  const order = await fetch(`${ORDERS_API}/orders/${order_id}`).then((r) => r.json());

  ws.send(JSON.stringify({
    type: "response.item.create",
    item: { type: "function_call_output", call_id: ev.item.call_id, output: JSON.stringify(order) },
  }));
  ws.send(JSON.stringify({ type: "response.create" }));
});

Üç detay insanları zorluyor:

Sequence of a GPT-Live-1.1 function call: the caller asks about order 123, GPT-Live-1.1 acknowledges and delegates, the backend model sends a function_call to your app inside response.event, your app returns function_call_output and response.create, and GPT-Live-1.1 speaks the answer

GPT-Live-1.1 fiyatlandırması ve limitler

Ses süresinin maliyetini hesaplamak kolaydır. Boyunca aktif kalan 5 dakikalık bir destek çağrısı, ses süresi olarak 5 × 0,05 $ = 0,25 $ tutar. Bin tanesi 250 $ eder; bunun üzerine backend model ve araçlar normal tarifeleriyle faturalandırılır.

Maliyet kalemi Oran
Aktif ses Dakika başına 0,05 $
Bekleme sesi (WebRTC, çıkarım duraklatılmış) Dakika başına 0,02 $
WebRTC başlatma 15 saniye, oturum çalışmaya başladığında iade edilir
Backend model ve araçlar İlgili model ve araç için normal fiyatlandırma

Hız limitleri token değil, eşzamanlı oturum sayısını hesaba katar. GPT-Live-1.1 ve GPT-Live-1, çıkarım bölgeleri genelinde geçerli ayrı limitlere sahiptir. GPT-Live-1 sayfası, Build, Launch ve Grow katmanları için sırasıyla 50, 300 ve 500 eşzamanlı oturum listeler; Free katmanı erişimi yoktur. 1.1 sayfası bir sayı vermiyor, bu yüzden bir lansmandan önce organizasyonunuzun limitler sayfasını kontrol edin.

Kodlama ajanınızın araç backend’ini Apidog CLI ile test etmesine izin verin

Ses ajanınız, get_order fonksiyonunun arkasındaki API kadar güvenilirdir. Yavaş veya bozuk bir yanıt, ölü bir sessizliğe ya da yüksek sesle söylenen yanlış bir cevaba dönüşür. Bu yüzden herhangi bir arayan bu backend’i duymadan önce test edin ve bu işi kodlama ajanınıza Apidog CLI ile yaptırın.

Tek seferde kurun:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install

Ardından Claude Code, Codex veya Cursor’a tek bir istem verin:

Import ./orders-openapi.yaml into Apidog project <projectId>. Create test cases for
GET /orders/{order_id}: a known ID returns 200 with a status field in under 800 ms,
and an unknown ID returns 404 with a JSON error. Run them against the staging
environment and tell me what failed.

Ajan şemayı okur, yükünü doğrular, test durumlarını oluşturur ve çalıştırır:

apidog import --project <projectId> --format openapi --file ./orders-openapi.yaml
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json

800 ms bütçesi ses için önemlidir: arayan, aracınızın aldığı her milisaniyeyi duyar. Aynı apidog run komutunu -r junit ile CI’a ekleyin ki bir gerileme build’i düşürsün; bkz. Apidog CLI CI/CD rehberimiz. Ajan iş akışında yeni misiniz? Claude Code’da Apidog CLI yazısıyla başlayın. Apidog’un Free planı 4 kullanıcıya kadar kapsar.

SSS

GPT-Live-1.1 API’de mevcut mu? Evet. 20 Kasım 2026’den beri gpt-live-1.1 modelini v1/live/sessions üzerinde WebRTC, WebSocket veya SIP ile çağırabilirsiniz. v1/realtime, v1/responses veya Chat Completions üzerinde sunulmaz.

GPT-Live-1.1 API ne kadar? Aktif dakika başına 0,05 $ ve bekleme dakikası başına 0,02 $. Backend model çağrıları ve araçlar kendi tarifeleriyle ayrıca faturalandırılır.

GPT-Live-1.1 ile GPT Realtime arasındaki fark nedir? GPT-Live kendi uç noktasında çalışır, ses süresine göre faturalanır ve akıl yürütmeyi delegasyon yoluyla bir backend modele devreder. GPT Realtime ise v1/realtime üzerinde çalışır. GPT-Live vs GPT Realtime karşılaştırmamıza göz atın.

Delegasyon için hangi backend modeli kullanmalıyım? OpenAI’ın rehberi başlangıç için gpt-6-luna, daha karmaşık backend görevleri için gpt-6-sol öneriyor. Gecikme maliyetten daha önemliyse service_tier değerini priority yapın.

Responses modeli yerine kendi ajanımı kullanabilir miyim? Evet. delegation.type değerini client yapın. Uygulamanız backend işini çalıştırır ve sonuçları session.commentary.append ile geri gönderir. Transkriptleri de kendiniz takip edersiniz.

GPT-Live-1.1 fonksiyon çağırma destekliyor mu? Evet, Responses delegasyonu aracılığıyla. Fonksiyonları delegation.responses.tools içinde tanımlayın, çağrıları response.event üzerinden okuyun ve sonuçları response.item.create artı response.create ile döndürün.

API Tasarım-Öncelikli Yaklaşımı Apidog'da Uygulayın

API'leri oluşturmanın ve kullanmanın daha kolay yolunu keşfedin