Public Home / Document / AI Primitive API Docs

AI Primitive API Docs

Tài liệu public cho API chat, speech-to-text, text-to-text và flow multi-step.

Public API Docs

Fast, practical API cases for public users.

Four core cases only: single request, chat with brain, speech to text, and multi-step flow.

4 cases Pricing Login

Single request

Text-to-text request

Rewrite, summarize, classify, extract, translate, JSON output.

single

curl -X POST 'https://ai-center.shin520.net/api/v1/ai/text-to-text' \
  -H 'X-API-KEY: YOUR_API_KEY' \
  -F 'model=gpt-4o' \
  -F 'input_text=Viết lại đoạn này ngắn gọn hơn.' \
  -F 'instruction=Viết ngắn gọn, rõ ràng, giữ nguyên ý nghĩa.' \
  -F 'system_prompt=Bạn là trợ lý biên tập nội dung.' \
  -F 'tone=chuyên nghiệp' \
  -F 'temperature=0.4'

Brain chat

Chat with session brain

Support bot, knowledge base, assistant nội bộ.

brain

curl -X POST 'https://ai-center.shin520.net/api/v1/ai/chat' \
  -H 'X-API-KEY: YOUR_API_KEY' \
  -F 'model=gpt-4o' \
  -F 'session_id=demo-session-20260627041034' \
  -F 'system_prompt=Bạn là trợ lý hỗ trợ.' \
  -F 'reference_text=Đây là policy nội bộ và FAQ của công ty.' \
  -F 'messages=[{"role":"user","content":"Hãy trả lời theo tài liệu này."}]'

Speech to Text

Audio to transcript

Meeting notes, voice memo, call transcript, podcast transcript.

speech

curl -X POST 'https://ai-center.shin520.net/api/v1/ai/speech-to-text' \
  -H 'X-API-KEY: YOUR_API_KEY' \
  -F 'model=whisper-1' \
  -F 'language=vi' \
  -F 'prompt=Chuyển lời nói sang văn bản chính xác, giữ nguyên tên riêng.' \
  -F 'audio_file=@/path/to/audio.mp3'

Flow

Multi-step flow builder

Ghép speech -> text -> xử lý tiếp, hoặc text -> extract -> format.

flow

curl -X POST 'https://ai-center.shin520.net/api/v1/ai/flow' \
  -H 'X-API-KEY: YOUR_API_KEY' \
  -F 'model=gpt-4o' \
  -F 'session_id=demo-session-20260627041034' \
  -F 'reference_text=Đây là tài liệu nền cho flow.' \
  -F 'steps=[{"type":"speech_to_text","model":"whisper-1","language":"vi"},{"type":"text_to_text","instruction":"Tóm tắt transcript thành checklist hành động.","system_prompt":"Bạn là trợ lý vận hành."}]'

Quick links

Links

Pricing Chat App Private Docs