API Reference
Tenkai API Suite v1 — RESTful API for visual AI models.
Base URL: https://tenkai.click/v1
Auth: Authorization: Bearer tk_live_xxxx
Auth: Authorization: Bearer tk_live_xxxx
POST /v1/predictions Create a prediction ▶
{
"model": "tenkai/image-restoration",
"input": {
"image": "https://example.com/photo.jpg",
"prompt": "high quality, sharp details",
"upscale": 4
},
"webhook": "https://yourserver.com/webhook"
} Tip: Add Prefer: wait=30 header for sync mode.
GET /v1/predictions/{id} Get prediction status ▶
starting → processing → succeeded
{
"id": "pred_abc123",
"status": "succeeded",
"output": "https://tenkai.click/outputs/pred_abc123/output.png",
"metrics": { "predict_time": 3.21 }
} POST /v1/predictions/{id}/cancel Cancel a prediction ▶
{ "id": "pred_abc123", "status": "canceled" } GET /v1/models List available models ▶
{
"data": [
{ "id": "tenkai/image-restoration", "name": "Image Restoration (HYPIR)" },
{ "id": "tenkai/image-generation", "name": "Image Generation (FLUX.2 klein)" },
{ "id": "tenkai/video-super-resolution", "name": "Video Super-Resolution (SeedVR2)" },
{ "id": "tenkai/video-generation", "name": "Video Generation (LTX-Video)" },
{ "id": "tenkai/segmentation", "name": "Segmentation (SAM3)" }
]
} GET /v1/models/{id}/schema Get model I/O schema ▶
{
"input": {
"type": "object",
"properties": {
"image": { "type": "string", "format": "uri" },
"prompt": { "type": "string" },
"upscale": { "type": "integer", "default": 4 }
},
"required": ["image"]
}
}