OpenAI compatible protocol

Connect OpenAI compatible clients with the /v1 Base URL.

Common endpoints

This page lists OpenAI compatible text, Responses, image, video-task, audio, vector, moderation, and realtime endpoints. Video parameters and polling flow have a separate guide; actual availability depends on the model and Key group.

Models and discovery

Purpose	Method	Path
Model list	GET	/v1/models

Text and responses

Purpose	Method	Path
Text completions (legacy)	POST	/v1/completions
Chat completions	POST	/v1/chat/completions
Responses	POST	/v1/responses
Responses compaction	POST	/v1/responses/compact

Images

Purpose	Method	Path
Image generation	POST	/v1/images/generations
Image edits	POST	/v1/images/edits

Video tasks

Purpose	Method	Path
Create a video task	POST	/v1/videos
Get video task status	GET	/v1/videos/{task_id}
Get video content	GET	/v1/videos/{task_id}/content
Create video generation task (compatible)	POST	/v1/video/generations
Get video generation task (compatible)	GET	/v1/video/generations/{task_id}

Audio

Purpose	Method	Path
Audio transcription	POST	/v1/audio/transcriptions
Audio translation	POST	/v1/audio/translations
Text to speech	POST	/v1/audio/speech

Vectors and retrieval

Purpose	Method	Path
Text embeddings	POST	/v1/embeddings
Document reranking	POST	/v1/rerank

Safety and realtime

Purpose	Method	Path
Content moderation	POST	/v1/moderations
Realtime (WebSocket)	GET	/v1/realtime

Minimal request

Clients usually use https://api.popgo.site/v1 as the Base URL and Authorization: Bearer YOUR_API_KEY for authentication. Replace YOUR_MODEL with an ID from the model page and confirm that the model supports the target endpoint.

curl https://api.popgo.site/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL",
    "messages": [
      {"role": "user", "content": "Reply with a connection confirmation"}
    ]
  }'

Verify

Verify the model and protocol with a minimal request before enabling streaming, tools, image, or audio options. For a 404, check that the Base URL did not receive a second /v1; for a 400, check endpoint capability.