{"id":30528010,"url":"https://github.com/LumaAI-API/Luma-API","last_synced_at":"2025-08-27T04:03:18.660Z","repository":{"id":244812664,"uuid":"816241069","full_name":"LumaAI-API/Luma-API","owner":"LumaAI-API","description":"This is an unofficial LumaAI Dream Machine API based on Golang and Gin. It currently supports generating videos. ","archived":false,"fork":false,"pushed_at":"2024-08-01T07:57:22.000Z","size":16572,"stargazers_count":78,"open_issues_count":0,"forks_count":32,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-08-01T09:27:51.913Z","etag":null,"topics":["luma","luma-ai","luma-api","lumalabs"],"latest_commit_sha":null,"homepage":"https://lumalabs.ai","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LumaAI-API.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"license","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-17T10:32:54.000Z","updated_at":"2024-08-01T07:57:27.000Z","dependencies_parsed_at":null,"dependency_job_id":"128ba627-2ebe-4963-ba75-68d17e42c0b5","html_url":"https://github.com/LumaAI-API/Luma-API","commit_stats":null,"previous_names":["lumaai-api/luma-api"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/LumaAI-API/Luma-API","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LumaAI-API%2FLuma-API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LumaAI-API%2FLuma-API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LumaAI-API%2FLuma-API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LumaAI-API%2FLuma-API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LumaAI-API","download_url":"https://codeload.github.com/LumaAI-API/Luma-API/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LumaAI-API%2FLuma-API/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272288944,"owners_count":24907778,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-27T02:00:09.397Z","response_time":76,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["luma","luma-ai","luma-api","lumalabs"],"created_at":"2025-08-27T04:02:11.019Z","updated_at":"2025-08-27T04:03:18.643Z","avatar_url":"https://github.com/LumaAI-API.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# Luma API\r\n[中文](./README_ZH.md)\r\n\r\nUsing Golang, convert the video capabilities of the LumaAI Dream Machine into an API format for calls, making it easier to integrate quickly into third-party systems.\r\n\r\n## Disclaimer\r\n- This project is released on GitHub under the MIT license, free and open-source for educational purposes.\r\n\r\n# Good news\r\nI provide the Luma AI API, no deployment is required, no subscription to Luma is required. Lower price, more convenient to use the Luma API.\r\n#### Website: https://api.bltcy.ai\r\n\r\n## Supported Features\r\n- [x] Luma API supports video generation and allows uploading reference images.\r\n- [x] Users can upload reference images in advance or provide third-party image links or base64 encoded images when submitting video tasks.\r\n- [x] API interface security verification.\r\n- [x] Simplified deployment process, supporting both docker-compose and docker.\r\n- [x] Provides standardized services compatible with OpenAI's interface format, supporting both streaming and non-streaming output.\r\n- [x] Supports customization of the OpenAI Chat response format based on Go Template syntax.\r\n- [x] Compatible with frontend projects like chat-next-web.\r\n- [x] Automatic keep-alive (max keep-alive 7 days).\r\n- [] Adapts to intermediary projects like New API.\r\n- [] Pre-detection of sensitive words.\r\n\r\n## Supported Endpoints\r\nVideo generation, supports uploading two images (start and end).\r\n[x] /generations\r\nVideo extension, extends by 5 seconds each time.\r\n[x] /generations/:task_id/extend\r\nQuery single video task.\r\n[x] /generations/:task_id\r\nPre-upload images.\r\n[x] /generations/file_upload\r\nGet download URL without watermark.\r\n[x] /generations/:task_id/download_video_url\r\nGet account subscription information (balance, etc.).\r\n[x] /subscription/usage\r\nGet account information.\r\n[x] /users/me\r\n\r\n## Web UI\r\nhttps://github.com/Dooy/chatgpt-web-midjourney-proxy  \r\nOnline  \r\nhttps://api-chat.gptbest.vip\r\n\r\n## API Docs\r\n\r\nhttp://localhost:8000/swagger/index.html\r\n\r\n#### Request example\r\n```bash\r\ncurl --location 'http://localhost:8000/luma/generations/' \\\r\n--header 'Authorization: Bearer {SECRET_TOKEN}' \\\r\n--header 'Content-Type: application/json' \\\r\n--data '{\r\n    \"user_prompt\": \"Increase dynamic\",\r\n    \"aspect_ratio\": \"16:9\",\r\n    \"expand_prompt\": true,\r\n    \"image_url\": \"https://api.bltcy.ai/logo.png\" \r\n}'\r\n```\r\n\r\n#### Response example\r\n```bash\r\n{\r\n    \"created_at\": \"2024-06-18T14:47:43.318498Z\",\r\n    \"estimate_wait_seconds\": null,\r\n    \"id\": \"a4a8f1ff-e59b-4969-abcb-98b3e16f003e\",\r\n    \"liked\": null,\r\n    \"prompt\": \"Increase dynamic\",\r\n    \"state\": \"pending\",\r\n    \"video\": null\r\n}\r\n```\r\n\r\n## Deployment\r\n\r\n### Configuration\r\nLog in using Google Chrome https://lumalabs.ai/dream-machine/\r\nGet cookie\r\n![cookie](./docs/images/cookie.jpg)\r\n\r\n\r\n### Env Environment Variables\r\n| env         | description                                                                                                                                | default value                                  |\r\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------|\r\n| COOKIE      | Cookie obtained from the image above for the Luma account                     | None                                           | \r\n| BASE_URL    | Request API URL for Luma                                                                                                                   | https://internal-api.virginia.labs.lumalabs.ai | \r\n| PROXY       | HTTP proxy\t                                                                                                                                | None                                           | \r\n| PORT        | Port                                                                                                                                       | 8000                                           | \r\n| SECRET_TOKEN | Luma API seurity http header Bearer token                                                                                                  | None                                           |\r\n| ROTATE_LOGS | Whether to rotate logs daily\t                                                                                                              | Yes                                            | \r\n| LOG_DIR     | Log output path                                                                                                                            | ./logs                                         | \r\n| DEBUG       | Whether to enable Debug logging\t                                                                                                           | No                                             | \r\n| PPROF       | Whether to enable Pprof performance analysis, uses port 8005 if enabled\t                                                                   | No                                             |\r\n| CHAT_TIME_OUT | Chat request time out                                                                                                                      | 600 s                                          |\r\n| CHAT_TEMPLATE_DIR | Chat template path                                                                                                                         | ./template                                     |\r\n\r\n\r\n### Docker Deployment\r\nStep-by-step guide on how to run a Docker container with specific environment variables and port mappings. Sensitive details like SQL names, passwords, and IP addresses are replaced with placeholders for this guide.\r\n\r\n```bash\r\ndocker run --name luma-api -d -p 8000:8000 \\\r\n-e COOKIE=xxxx  \\\r\n lumaapi/luma-api\r\n```\r\n\r\ndocker-compose deployment\r\n```bash\r\ndocker-compose pull \u0026\u0026 docker-compose up -d\r\n```\r\n\r\ndocker-compose.yml\r\n```bash\r\nversion: '3.2'\r\n\r\nservices:\r\n  sunoapi:\r\n    image: lumaapi/luma-api:latest\r\n    container_name: luma-api\r\n    restart: always\r\n    ports:\r\n      - \"8000:8000\"\r\n    volumes:\r\n      - ./logs:/logs\r\n    environment:\r\n      - COOKIE=xxxx\r\n```\r\n\r\n### Local Deployment\r\n- Golang 1.20+\r\n\r\n```bash\r\ngit clone https://github.com/LumaAI-API/Luma-API.git\r\ncd Luma-API\r\ngo mod tidy\r\n```\r\n\r\n## License\r\nMIT © [Luma API](./license)\r\n\r\n## Buy Me a Coke\r\n![zanshangcode.jpg](./docs/images/zanshangcode.jpg)\r\n\r\nThis project is open-source on GitHub under the MIT license and is free of charge. If you find this project helpful, please give it a star and share it. Thank you for your support!\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLumaAI-API%2FLuma-API","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FLumaAI-API%2FLuma-API","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLumaAI-API%2FLuma-API/lists"}