Learn how to integrate GenVR's AI models into your applications
Create a project and get your User ID and Access Token from the GenVR Teams page.
Use the code examples in the model documentation to integrate the API.
# Step 1: Generate
curl -X POST https://api.genvrresearch.com/api/v1/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"uid": "YOUR_USER_ID",
"category": "imagegen",
"subcategory": "flux_dev",
"prompt": "a beautiful sunset"
}'
# Returns: {"success": true, "data": {"id": "task-123", "status": "starting"}}
# Step 2: Poll Status (repeat until "completed")
curl -X POST https://api.genvrresearch.com/api/v1/status \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"id": "task-123",
"uid": "YOUR_USER_ID",
"category": "imagegen",
"subcategory": "flux_dev"
}'
# Returns: {"success": true, "data": {"id": "task-123", "status": "completed"}}
# Step 3: Get Response (REQUIRED - only place to get output)
curl -X POST https://api.genvrresearch.com/api/v1/response \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"id": "task-123",
"uid": "YOUR_USER_ID",
"category": "imagegen",
"subcategory": "flux_dev"
}'
# Returns: {"success": true, "data": {"status": "completed", "output": ["https://...png"]}}Use these GET endpoints to discover models, schemas, and download integration code:
GET /api/modelsList all available modelsGET /api/schema/:category/:subcategoryGet model parameter schemaGET /api/openai-function/:category/:subcategoryDownload OpenAI functionGET /api/comfyui-node/:category/:subcategoryDownload ComfyUI nodehttps://api.genvrresearch.comAll requests require a Bearer token in the Authorization header:
Authorization: Bearer YOUR_API_KEYPOST /api/v1/generateStart generationPOST /api/v1/statusCheck statusPOST /api/v1/responseGet final resultRequired in every API request:
uid - Your user identifiercategory - Model category (e.g., "imagegen")subcategory - Model identifier (e.g., "flux_dev")Authorization header with your API keyEach AI model has its own unique input parameters (like prompt, aspect_ratio, seed, etc.).
Browse the model library and click on any model to see its complete parameter documentation with examples in 6 programming languages.
Send your input to the generate endpoint. You'll receive a task ID to track your request.
POST /api/v1/generate → Returns: {"data": {"id": "task-123"}}Check the status endpoint every 1-2 seconds until the status is "completed" or "failed". Status never returns output - only progress updates.
POST /api/v1/status → Returns status onlyAlways call this endpoint once status is "completed" to get your results. All models use this unified pattern - output is only available via /response.
POST /api/v1/response → Returns: {"output": ["url1", "url2"]}All models return one of three standardized status values:
processingGeneration in progress
completedReady to fetch results
failedError occurred
All models return output as an array, regardless of the number of results:
{
"success": true,
"data": {
"status": "completed",
"output": ["url1", "url2"]
}
}✓ Single result: ["url"]
✓ Multiple results: ["url1", "url2", ...]
Always call all 3 endpoints in order: generate → status → response. Never skip the response endpoint, even if you think the model might return output in status.
Output is always an array, even for single results. Access results with output[0] for the first item.
Always check the status field and handle "failed" status appropriately. The error message will be in data.error.
Poll the status endpoint every 1-2 seconds. Avoid polling too frequently to prevent rate limiting.
Set appropriate timeouts for your requests. Most models complete within 30-60 seconds, but complex operations may take longer.
Respect rate limits based on your subscription plan. Check your dashboard for current limits and usage.
Explore our complete collection of AI models across different categories.
Manage your API keys, check usage, and monitor your requests.
Join our community or contact support for assistance with integration.