Name: Image Generate – Text-to-Image & Edit | Free · $5/mo | API.market
Brand: astrosoft
SKU: api-astrosoft-low-cost-image-generate
Availability: InStock
Author: API Market

cin ceoi

```bash
aws sso login --region us-east-1
aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin 360717819118.dkr.ecr.us-east-1.amazonaws.com
docker build -t image_generate .
docker tag image_generate:latest 360717819118.dkr.ecr.us-east-1.amazonaws.com/image_generate:latest
docker push 360717819118.dkr.ecr.us-east-1.amazonaws.com/image_generate:latest
aws lambda update-function-code --region us-east-1 --function-name image_generate --image-uri "360717819118.dkr.ecr.us-east-1.amazonaws.com/image_generate:latest" --output json | jq -r ".CodeSha256"
aws lambda get-function --region us-east-1  --function-name image_generate --output json |jq -r ".Configuration.LastUpdateStatus"
```

以下可以一次性执行
```bash
docker build -t image_generate . ; docker tag image_generate:latest 360717819118.dkr.ecr.us-east-1.amazonaws.com/image_generate:latest ;docker push 360717819118.dkr.ecr.us-east-1.amazonaws.com/image_generate:latest ; aws lambda update-function-code --region us-east-1 --function-name image_generate --image-uri "360717819118.dkr.ecr.us-east-1.amazonaws.com/image_generate:latest" --output json | jq -r ".CodeSha256" ; aws lambda get-function --region us-east-1  --function-name image_generate --output json |jq -r ".Configuration.LastUpdateStatus"
```


This API provides various image generation and manipulation functionalities including text-to-image, image-to-image transformation, object removal, Ghibli style conversion, and image upload.



# Image Generation API Documentation

## Overview
Our API offers AI-powered image generation and editing capabilities, currently featuring:
1. Text-to-image conversion
2. Object removal from images
3. Image-to-image conversion
4. upload a local image file to get a URL

(More endpoints coming soon)


## Available Endpoints

### 1. Text-to-Image Generation
`POST /text_to_image`

**Description**  
Generate images from text descriptions.

Example: **A girl standing in a field of flowers with lake**

​<img src="https://apimarket-file.s3.us-east-1.amazonaws.com/samples/tmpzla4pmdp.jpg" width="300">

Example: **R3alisticF, hauntingly beautiful oriental necromancer, long flowing brown hair, bangs, darkly tanned skin, earrings, bone necklaces, dark eyeshadow, red lips, vibrant, front-laced transparent, filmy silk blouse, cleavage, in a sandstone room lit by candles, High Detail, Perfect Composition, high contrast, silhouetted, chiascuro**
<img src="https://apimarket-file.s3.us-east-1.amazonaws.com/samples/tmp2siz5pek.jpg" width="300">



**Request Demo**
```bash
curl -X 'POST' \
  'https://prod.api.market/api/v1/astrosoft/low-cost-image-generate/text_to_image' \
  -H 'accept: application/json' \
  -H 'x-api-market-key: YOUR-API-KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "prompt": "A girl standing in a field of flowers with lake",
  "negative_prompt": "blurry, low quality, text",
  "width": 1024,
  "height": 768
}'
```


### 2. Object Removal
`POST /object_remove`

**Description**  
Remove objects from an image using AI inpainting technology. Using original image and the mask image which mask the object area you want to remove to get the result.

Example:

<img src="https://apimarket-file.s3.us-east-1.amazonaws.com/samples/6a30c07e-92b5-4b60-b5cb-ae7aa3e254c9.webp" width="300">
<img src="https://apimarket-file.s3.us-east-1.amazonaws.com/samples/ff0da403-1b48-403a-a520-268eb824ddfe.webp" width="300">
<img src="https://apimarket-file.s3.us-east-1.amazonaws.com/samples/tmpp3p4_i8h.png" width="300">

**Request Demo**
```bash
curl -X 'POST' \
'https://prod.api.market/api/v1/astrosoft/low-cost-image-generate/object_remove' \
-H 'accept: application/json' \
-H 'x-api-market-key: YOUR-API-KEY' \
-H 'Content-Type: application/json' \
-d '{
    "init_image":"https://apimarket-file.s3.amazonaws.com/samples/6a30c07e-92b5-4b60-b5cb-ae7aa3e254c9.webp",
    "mask_image":"https://apimarket-file.s3.amazonaws.com/samples/ff0da403-1b48-403a-a520-268eb824ddfe.webp"
}''
```

**Mask Image Specification**
- White areas (#FFFFFF): Objects to be removed
- Black areas (#000000): Areas to preserve
- Must be single-channel (grayscale)
- Should match dimensions of init_image


### 3. Image-to-image generation
`POST /image_to_image`

**Description**  
This API gives you a easy way to modify image without complex workflow, it is designed for advanced image editing.

Here's Examples:

**change the image to a winter snow day**

<img src="https://apimarket-file.s3.us-east-1.amazonaws.com/samples/01bed3a3-5475-40bb-b3b7-409752ccdd29.jpeg" width="300">
<img src="https://apimarket-file.s3.us-east-1.amazonaws.com/samples/tmpthr1g7ah.png" width="300">


**change the image to a night scence ,building fill of turned on lights, and there is half moon in the sky**

<img src="https://apimarket-file.s3.us-east-1.amazonaws.com/samples/tmpno5_0rf7.png" width="500">


**Request Demo**
```bash
curl -X 'POST' \
'https://prod.api.market/api/v1/astrosoft/low-cost-image-generate/image_to_image' \
-H 'accept: application/json' \
-H 'x-api-market-key: YOUR-API-KEY' \
-H 'Content-Type: application/json' \
-d '{
    "init_image":"https://apimarket-file.s3.us-east-1.amazonaws.com/samples/01bed3a3-5475-40bb-b3b7-409752ccdd29.jpeg",
    "prompt":"change the image to a winter snow day",
}'
```

### 4. upload image
`POST /upload`

**Description**  
Upload your local image file to get a URL for future using.

**Request Demo**
```bash
curl -X POST \
'https://prod.api.market/api/v1/astrosoft/low-cost-image-generate/upload' \
  -H "x-magicapi-key: your-api-key-here" \
  -H "Content-Type: multipart/form-data" \
  -F "file1=@./file1.jpg;type=image/jpeg" \
  -F "file2=@./file2.jpg;type=image/png" \
```



## Error Handling
**Common Error Responses**
```json
{
    "status": "error",
    "message": "Invalid API key"
}
```

```json
{
    "status": "error",
    "message": "Prompt cannot be empty"
}
```

```json
{
    "status": "error",
    "message": "Mask image must be black and white"
}
```

```json
{
    "status": "error",
    "message": "init_image and mask_image dimensions must match"
}
```

---

&gt; Note: This documentation will be updated as new endpoints become available. Last updated: 2025-09-27



Generate images from text, edit photos, and remove objects. Free 10 calls/mo, paid plans from $5/mo. Start free on API.market.

Image Generate – Text-to-Image & Edit | Free · $5/mo | API.market

Basic