README.md

metadata

title: Japanese AI Interview API
emoji: 🎤
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860

Japanese AI Interview API

Role-based, voice-first Japanese interview practice for working visa jobs.

This build uses

• Hugging Face Inference ASR for speech-to-text
• Hugging Face router chat completions for dynamic next-question logic
• A built-in 654-question bank across 6 job roles
• N4-level interviewer style
• Early fail after repeated no-sound or weak answers
• Up to 20 questions when the interview is going well

Endpoints

• GET /
• GET /health
• GET /roles
• POST /start
• POST /answer

Space secrets / variables

Secret

• HF_TOKEN = Hugging Face token with Inference Providers permission

Variables

• ASR_MODEL = openai/whisper-large-v3
• CHAT_MODEL = Qwen/Qwen2.5-7B-Instruct-1M
• MAX_QUESTION_LIMIT = 20

Start payload example

{
  "session_uuid": "session-123",
  "job_role": "construction",
  "question_count": 12
}

Available job_role values

• construction
• restaurant_konbini
• nursing_care
• hotel_accommodation
• agriculture
• manufacturing