{"openapi":"3.1.0","info":{"title":"Rivermoon Image Studio API","version":"1.0.0","description":"Image generation and image editing API. Use Bearer API Key; billing is deducted from the API key owner wallet."},"servers":[{"url":"https://image.twotop.icu"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"ImageGenerationRequest":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","minLength":2,"maxLength":4000},"quality":{"type":"string","enum":["1k","2k","standard","high"],"default":"2k"},"size":{"type":"string","enum":["1024x1024","1536x1024","1024x1536"],"default":"1024x1024"},"output_format":{"type":"string","enum":["jpeg","png","webp"],"default":"jpeg"},"n":{"type":"integer","enum":[1,2,4],"default":1}}},"ImageGenerationResponse":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","example":"image.generation"},"created":{"type":"integer"},"model":{"type":"string"},"mode":{"type":"string","enum":["generate","edit"]},"quality":{"type":"string"},"size":{"type":"string"},"output_format":{"type":"string"},"count":{"type":"integer"},"price_cents":{"type":"integer"},"balance_cents":{"type":"integer"},"data":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"b64_json":{"type":["string","null"]},"mime_type":{"type":"string"},"output_format":{"type":"string"}}}}}}}},"security":[{"bearerAuth":[]}],"paths":{"/v1/images/generations":{"post":{"summary":"Generate images from a prompt","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageGenerationRequest"}}}},"responses":{"200":{"description":"Image generation result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageGenerationResponse"}}}},"401":{"description":"Invalid API key"},"402":{"description":"Insufficient balance"},"429":{"description":"Rate limited or concurrent generation"}}}},"/v1/images/edits":{"post":{"summary":"Edit images with one to four source images","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["prompt","image"],"properties":{"prompt":{"type":"string","minLength":2,"maxLength":4000},"image":{"type":"array","maxItems":4,"items":{"type":"string","format":"binary"}},"mask":{"type":"string","format":"binary"},"quality":{"type":"string","enum":["1k","2k","standard","high"],"default":"2k"},"size":{"type":"string","enum":["1024x1024","1536x1024","1024x1536"],"default":"1024x1024"},"output_format":{"type":"string","enum":["jpeg","png","webp"],"default":"jpeg"},"n":{"type":"integer","enum":[1,2,4],"default":1}}}}}},"responses":{"200":{"description":"Image edit result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageGenerationResponse"}}}},"401":{"description":"Invalid API key"},"402":{"description":"Insufficient balance"},"429":{"description":"Rate limited or concurrent generation"}}}}}}