{"id":42507526,"url":"https://github.com/solspace/strapi-plugin-imagiterate","last_synced_at":"2026-01-28T13:48:39.838Z","repository":{"id":317091684,"uuid":"1065914242","full_name":"solspace/strapi-plugin-imagiterate","owner":"solspace","description":"AI plugin for Strapi.io that supports image editing iterations with data saving to the Strapi backend","archived":false,"fork":false,"pushed_at":"2025-10-31T15:53:03.000Z","size":17232,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-10T03:44:32.368Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/solspace.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-28T17:22:48.000Z","updated_at":"2025-10-31T15:53:07.000Z","dependencies_parsed_at":"2025-09-28T20:40:06.355Z","dependency_job_id":"0ddf9855-7ae5-4189-ac69-2d68ccb3823e","html_url":"https://github.com/solspace/strapi-plugin-imagiterate","commit_stats":null,"previous_names":["solspace/strapi-plugin-imagiterate"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/solspace/strapi-plugin-imagiterate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solspace%2Fstrapi-plugin-imagiterate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solspace%2Fstrapi-plugin-imagiterate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solspace%2Fstrapi-plugin-imagiterate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solspace%2Fstrapi-plugin-imagiterate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/solspace","download_url":"https://codeload.github.com/solspace/strapi-plugin-imagiterate/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solspace%2Fstrapi-plugin-imagiterate/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28846056,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-28T13:02:32.985Z","status":"ssl_error","status_checked_at":"2026-01-28T13:02:04.945Z","response_time":57,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2026-01-28T13:48:39.227Z","updated_at":"2026-01-28T13:48:39.829Z","avatar_url":"https://github.com/solspace.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Strapi Plugin Imagiterate\n\nPrompt an AI to iterate on uploaded images and save them to Strapi's backend.\n\n## Features\n\n- Opens up the world of AI image editing to Strapi users\n- Streamlines AI editing of images\n- Saves iterative results in Strapi\n- Use saved image iterations as normal Strapi content and media types\n\n## Installation\n\nTo install this plugin, you need to add an NPM dependency to your Strapi application.\n\n```sh\n# Using Yarn\nyarn add @solspace/strapi-plugin-imagiterate\n\n# Or using PNPM\npnpm add @solspace/strapi-plugin-imagiterate\n\n# Or using NPM\nnpm install @solspace/strapi-plugin-imagiterate\n```\n\n## How it works\nThis plugin has an interface within the Strapi Admin Panel as well as API endpoints for use in your websites.\n\n### Strapi Admin Panel\nThis plugin creates an AI image editing interface in the Strapi Admin Panel. You can find it as a widget in your Strapi home screen or as a custom field in the Imagiterate Uploads Collection.\n\nUsers can iterate on images and save their work as Strapi Media Assets. The plugin also generates alternative text for images using AI.\n\n### API Endpoints\nThis plugin also exposes two Strapi API endpoints, one for initial image uploads and another for subsequent image iterations.\n\nDevelopers can build front-end applications that consume this API and allow users to upload an image along with an editing prompt. The AI modifies the image and returns the modified version through the API. The developer's front-end application can then allow the user to provide further editing prompts to iterate on subsequent modified images.\n\nAll image uploads and modifications are saved to the Strapi back-end in the Imagiterate Uploads collection. The images are saved as Strapi Media Library records attached to a main collection entry.\n\n## Requirements\nThis plugin is optimized for and currently uses the AI image editing service provider [Replicate](https://replicate.com/).\n\n- **Required:** A valid Replicate API token with valid billing credits attached to it.\n\n## Configuration\n\n1. Add environment configuration values:\n\n`.env`\n\n```\n# Replicate API Token\nREPLICATE_API_TOKEN=r8_HrsCGGANKqOTmmJQhsbpIHBNMBOfHwz9JMaiQ\n\n# Replicate AI Model\nREPLICATE_AI_MODEL=black-forest-labs/flux-kontext-pro\n\n# Replicate Caption Model\nREPLICATE_CAPTION_MODEL=salesforce/blip:2e1dddc8621f72155f24cf2e0adbde548458d3cab9f00c0139eea840d0ac4746\n```\n\n2. Then set up your Strapi plugins config file to use those values. Note the addition of { env} as a function argument. And make sure you merge these config values in with whatever other plugins you are also running.\n\n`config/plugins.ts`\n\n```\nexport default ({ env }) =\u003e ({\n\t'imagiterate': {\n\t\tenabled: true,\n\t\tconfig: {\n\t\t  replicateApiToken: env('REPLICATE_API_TOKEN'),\n\t\t  replicateAiModel: env('REPLICATE_AI_MODEL'),\n\t\t  replicateCaptionModel: env('REPLICATE_CAPTION_MODEL'),\n\t\t},\n\t},\n});\n```\n\n## Permissions\n\nWhen you choose to use the Imagiterate API, access and permissions for Imagiterate API endpoints is managed through Strapi. You can create a dedicated API token in Strapi and use that in your API calls. Enable both `iterate` and `upload` controller actions.\n\nIt is strongly recommended that you not enable API access through User \u0026 Permissions Plugin Roles.\n\n## API\n\nThere are two API endpoints for Imagiterate; Upload and Iterate. The upload endpoint takes the original image file along with a prompt. That original image is edited, saved to the Strapi backend and returned along with some other data. The iterate endpoint receives an image url and a prompt and edits the given image. That new image is saved to the Strapi backend and returned with additional data.\n\n### Upload\n\n`POST /api/imagiterate/upload`\n\nThe `upload` endpoint expects [FormData](https://developer.mozilla.org/en-US/docs/Web/API/FormData).\n\n```\n\tconst formData = new FormData();\n\tformData.append(\"image\", originalImageFile);\n\tformData.append(\"prompt\", currentPrompt);\n```\n\nTwo values are expected:\n\n- image\n  - The contents of 'image' will be the equivalent of the contents of an HTML form input field of type 'file' with a name of 'image'.\n- prompt\n  - The 'prompt' is a string that describes the edits to make to a submitted image.\n\nThe `upload` method creates a new entry in the Imagiterate Uploads collection. It returns that object in a standard Strapi API response for a [Document Service findOne()](https://docs.strapi.io/cms/api/document-service#findone) call with some additions.\n\n- token\n  - Imagiterate generates a unique token after each valid API call. This new token is expected to be provided in the next API call.\n- url\n  - The edited image is available through this url.\n- prompt\n  - The submitted AI prompt is returned for reference.\n\n### Iterate\n\n`POST /api/imagiterate/iterate`\n\nThe `iterate` endpoint expects a standard POST request payload. Four values are required:\n\n- documentId\n  - This is the Imagiterate Uploads collection document id. Subsequent iteration images get attached to the initial Imagiterate Uploads document.\n- url\n  - This is the new image created from the image submitted in the 'url' argument.\n- prompt\n  - The submitted AI prompt is returned for reference.\n- token\n  - This is the random UUID token provided in the previous Imagiterate API response.\n\n## Costs\n\nAI is not cheap. Replicate charges $0.04 per image output for the `black-forest-labs/flux-kontext-pro` AI model. This is an excellent model, but beware of costs accumulating.\n\n## Disclaimer\n\nSolspace, Inc. is not responsible for any costs incurred through your use of Imagirate and its integration with the Replicate AI service.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolspace%2Fstrapi-plugin-imagiterate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsolspace%2Fstrapi-plugin-imagiterate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolspace%2Fstrapi-plugin-imagiterate/lists"}