NPC에게 대사 보내기

매개변수

Lingara-Versionheaderstring선택

이 요청에 응답할 API 버전입니다. 지정하지 않으면 액세스 토큰은 해당 클라이언트에 고정된 버전을, 토큰이 없는 요청은 현재 버전을 받습니다. 개발 중인 버전은 여기에서 지정해야만 사용할 수 있습니다. 알 수 없는 버전에는 코드 api_version_unknown과 함께 400으로 응답합니다. GET /v1/versions에서 버전 목록을 확인할 수 있습니다.

요청 본문 application/json

npcNpc필수

namestring필수

personastring | null선택

scenestring | null선택

source_langstring필수

target_langstring필수

levelinteger필수

linestring필수

historyarray of DialogueEntry선택

지금까지의 대화로, 오래된 것부터 최대 12줄입니다. 창은 직접 보관합니다. Lingara는 턴 사이에 아무것도 저장하지 않습니다. NPC의 각 답변은 처음 500자로 잘라 다시 보내세요.

speakerSpeaker필수

textstring필수

응답

200 캐릭터의 답변, 조각조각

스트림 이벤트 text/event-stream

keepalive 주석을 보내지 않습니다.

delta TurnDelta

textstring필수

notice Notice

codestring필수

messagestring필수

done Done 스트림 종료

error StreamError 스트림 종료

200 응답 안에서 도착합니다. 상태 줄이 이미 전송되었으므로 스트림이 열린 뒤의 실패는 이 이벤트로 보고됩니다.

codestring필수

messagestring필수

plan_idstring | null선택

오류

402application/json

사용량 기반 과금 클라이언트의 호출이 아무것도 소모하기 전에 거부되었습니다. spend_cap_reached: 클라이언트 또는 그 계정이 월 지출 한도에 도달했습니다. 연동 페이지에서 한도를 올리세요. metered_billing_inactive: 이 계정에서 사용량 기반 과금이 활성화되어 있지 않습니다. 연동 페이지에서 설정하거나 결제 수단을 업데이트하세요.

410application/json

이 요청에 응답하는 API 버전은 지원이 종료되었습니다. Lingara-Version에 지원되는 버전을 보내거나 클라이언트를 다른 버전에 다시 고정하세요.

4XXapplication/json

요청이 거부되었습니다. code는 이유를, error는 이를 문장으로 알려 줍니다.

503application/json · text/plain

서비스를 일시적으로 사용할 수 없습니다. Retry-After에 있는 초만큼 기다린 후 다시 시도하세요. 점검 중에는 본문이 오류 엔벨로프가 아닌 일반 텍스트입니다.

5XXapplication/json

요청이 거부되었습니다. code는 이유를, error는 이를 문장으로 알려 줍니다.

codestring필수

요청이 거부된 이유를 분기에 쓸 수 있는 안정적인 코드로 나타냅니다. 예: insufficient_scope(403), rate_limited(429), 사용량 기반 과금 클라이언트의 경우 spend_cap_reached(402)와 metered_billing_inactive(402).

errorstring필수

예시

curl -N -X POST "https://api.getlingara.com/v1/embed/dialogue/turns" \
  -H "Authorization: Bearer $LINGARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"npc":{"name":"Auntie Lin","persona":"a street-food vendor who likes to haggle"},"scene":"A night market in Taipei, just after rain","source_lang":"en","target_lang":"zh","level":3,"line":"How much are the dumplings?","history":[{"speaker":"npc","text":"来来来，刚出锅的饺子！"},{"speaker":"player","text":"你好！"}]}'

라이브러리가 더 편하신가요? 라이브러리 섹션을 보세요.

스트림 예시

event: delta
data: {"text":"饺子十块钱一盘，"}

event: delta
data: {"text":"要几盘？"}

event: done
data: {}