{"openapi":"3.1.0","info":{"title":"BeTuber Character API","version":"1","description":"Generate an original rigged VTuber character and draw it as SVG. A character is a JSON look the BeTuber rig can wear: face, hair, body, species, outfit, and accessories. Rendering returns a still SVG of that look. This API does not call an image model. Plans to create on RapidAPI and API.market: Basic: $0/month, 100 characters, 50 renders, 10/minute. Pro: $19/month, 2000 characters, 1000 renders, 30/minute. Ultra: $79/month, 15000 characters, 8000 renders, 60/minute. Mega: $199/month, 80000 characters, 40000 renders, 120/minute. Name the RapidAPI subscriptions BASIC, PRO, ULTRA, and MEGA. A subscription reported as CUSTOM is billed as Pro. Quotas reset on the first day of each month, UTC. A 429 means the plan is spent until then. Charge customers on the marketplace. This origin meters the same quotas so a misconfigured hub cannot run without a limit.","contact":{"url":"https://betuber.com/"}},"servers":[{"url":"https://app.betuber.com/api/v1"}],"tags":[{"name":"Discovery"},{"name":"Characters"},{"name":"Account"}],"paths":{"/health":{"get":{"operationId":"health","tags":["Discovery"],"summary":"Service health","security":[],"responses":{"200":{"description":"The API process is up."}}}},"/ping":{"get":{"operationId":"ping","tags":["Discovery"],"summary":"Service ping (RapidAPI health check)","description":"Same as /health. RapidAPI Hub health checks default to /ping.","security":[],"responses":{"200":{"description":"The API process is up."}}}},"/catalog":{"get":{"operationId":"catalog","tags":["Discovery"],"summary":"Species, bodies, views, and plan quotas","responses":{"200":{"description":"Catalog and the quotas this origin enforces."}}}},"/characters":{"post":{"operationId":"createCharacter","tags":["Characters"],"summary":"Generate a VTuber character","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CharacterRequest"},"example":{"gender":"female"}}}},"responses":{"200":{"description":"A new character look."},"401":{"description":"Missing or rejected credentials."},"429":{"description":"Monthly quota or per-minute limit."}}}},"/characters/render":{"post":{"operationId":"renderCharacter","tags":["Characters"],"summary":"Draw a character look as SVG","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RenderRequest"},"example":{"look":{"skin":"#f3c7b6"},"view":"bust","height":720,"background":"#101820"}}}},"responses":{"200":{"description":"JSON by default. image/svg+xml when format is svg or the Accept header asks for SVG."},"400":{"description":"The look or the view is not valid."},"429":{"description":"Monthly quota or per-minute limit."}}}},"/usage":{"get":{"operationId":"usage","tags":["Account"],"summary":"Quota used in the current UTC month","responses":{"200":{"description":"Character and render counters for the caller."}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Direct key minted for this API. Marketplace calls use the hub key instead."},"rapidapiKey":{"type":"apiKey","in":"header","name":"X-RapidAPI-Key"}},"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":128},"description":"Retries with the same key return the first response and do not spend a second unit."}},"schemas":{"CharacterRequest":{"type":"object","properties":{"gender":{"type":"string","enum":["female","male","other"],"description":"Omit to let the API choose."}}},"RenderRequest":{"type":"object","required":["look"],"properties":{"look":{"type":"object","additionalProperties":true,"description":"The look object returned by POST /characters."},"view":{"type":"string","enum":["full","upper","bust","face"],"default":"bust"},"height":{"type":"integer","minimum":256,"maximum":1200,"default":720},"background":{"type":"string","nullable":true,"pattern":"^#[0-9A-Fa-f]{3,8}$"},"format":{"type":"string","enum":["json","svg"],"default":"json"}}}}},"security":[{"bearer":[]},{"rapidapiKey":[]}],"x-betuber-api":"betuber"}