logo

مستندات API - خدمات هوش مصنوعی لوما

به مستندات رسمی API‌های لوما خوش آمدید. این مستندات به شما کمک می‌کند تا با نحوه استفاده از API‌های ما برای پردازش تصاویر با استفاده از تکنولوژی‌های هوش مصنوعی آشنا شوید. در این مستندات، نحوه استفاده از هر API را با مثال‌های کامل در زبان‌های مختلف برنامه‌نویسی شامل پایتون، جاوااسکریپت و CURL توضیح داده‌ایم.

ساخت تصویر با متن

API تبدیل متن به تصویر به شما این امکان را می‌دهد که تصاویر را بر اساس توضیحات متنی که وارد می‌کنید، تولید کنید. با این API، شما می‌توانید تنظیمات مختلفی از جمله سبک، کیفیت و نسبت ابعاد تصویر را مشخص کنید.

پارامترهای ورودی:

1. Ai_engine(موتور هوش مصنوعی که برای تولید تصویر انتخاب می‌شود):

• Flux_11_pro • Flux_11_pro_ultra • Recraft • Flux_10_schnell

2. Image_style(سبک تصویر تولید شده):

• 3d • Bokeh • Cinematic • Creative • Dynamic • Fashion • Graphic • Minimalist • No_style • Back_and_white_sketch

3. Aspect Ratio(نسبت ابعاد تصویر):

• 1:1 • 3:4 • 4:3 • 16:9 • 9:16

4. Quality(کیفیت تصویر تولید شده):

• Normal • Good • Perfect

5. Hijab(در صورتی که نیاز به تصویر با حجاب باشد):

• ture • false

6. Prompt(توضیحات متنی که می‌خواهید بر اساس آن تصویر تولید شود. این متن باید مطابق با شرایط استفاده ما باشد)

پارامترهای خروجی:

1. Output_image(لینک به تصویر تولید شده)

مثال‌های درخواست API در زبان‌های مختلف:

1. درخواست با استفاده از CURL

در اینجا یک درخواست با استفاده از CURL برای ارسال داده‌ها به API آورده شده است:

1
curl -X POST https://api.lumma.ai/v1/text-to-image \
2
-H "Content-Type: application/json" \
3
-d '{
4
"Ai_engine": "Flux_11_pro",
5
"Image_style": "Cinematic",
6
"Aspect Ratio": "16_9",
7
"Quality": "Perfect",
8
"Hijab": "Yes",
9
"Prompt": "A futuristic city with flying cars and neon lights"
10
}'

2. درخواست با استفاده از پایتون

برای ارسال درخواست به API با استفاده از پایتون، می‌توانید از کتابخانه requests استفاده کنید:

1
import requests
2
3
url = "https://api.lumma.ai/v1/text-to-image"
4
headers = {
5
"Content-Type": "application/json"
6
}
7
data = {
8
"Ai_engine": "Flux_11_pro",
9
"Image_style": "Cinematic",
10
"Aspect Ratio": "16_9",
11
"Quality": "Perfect",
12
"Hijab": "Yes",
13
"Prompt": "A futuristic city with flying cars and neon lights"
14
}
15
16
response = requests.post(url, json=data, headers=headers)
17
18
if response.status_code == 200:
19
print("Image URL:", response.json()["Output_image"])
20
else:
21
print("Error:", response.status_code, response.text)

3. درخواست با استفاده از جاوااسکریپت (با استفاده از Fetch API)

برای ارسال درخواست به API با استفاده از پایتون، می‌توانید از کتابخانه requests استفاده کنید:

1
const url = 'https://api.lumma.ai/v1/text-to-image';
2
const headers = {
3
'Content-Type': 'application/json'
4
};
5
6
const data = {
7
"Ai_engine": "Flux_11_pro",
8
"Image_style": "Cinematic",
9
"Aspect Ratio": "16_9",
10
"Quality": "Perfect",
11
"Hijab": "Yes",
12
"Prompt": "A futuristic city with flying cars and neon lights"
13
};
14
15
fetch(url, {
16
method: 'POST',
17
headers: headers,
18
body: JSON.stringify(data)
19
})
20
.then(response => response.json())
21
.then(data => {
22
console.log("Image URL:", data.Output_image);
23
})
24
.catch(error => {
25
console.error("Error:", error);
26
});

حذف پس زمینه

API حذف پس‌زمینه به شما این امکان را می‌دهد که پس‌زمینه تصویر را حذف کنید و تنها سوژه اصلی تصویر باقی بماند.

پارامترهای ورودی:

1. Input_image(لینک عمومی به تصویر که مطابق با شرایط استفاده ما باشد)

پارامترهای خروجی:

1. Output_image(لینک به تصویر تولید شده)

مثال‌های درخواست API در زبان‌های مختلف:

1. درخواست با استفاده از CURL

در اینجا یک درخواست با استفاده از CURL برای ارسال داده‌ها به API آورده شده است:

1
curl -X POST https://api.lumma.ai/v1/text-to-image \
2
-H "Content-Type: application/json" \
3
-d '{ "Input_image": "https://example.com/image_to_remove_background.jpg" }'

2. درخواست با استفاده از پایتون

برای ارسال درخواست به API با استفاده از پایتون، می‌توانید از کتابخانه requests استفاده کنید:

1
import requests
2
3
url = "https://api.lumma.ai/v1/remove-background"
4
headers = {
5
"Content-Type": "application/json"
6
}
7
data = {
8
"Input_image": "https://example.com/image_to_remove_background.jpg"
9
}
10
11
response = requests.post(url, json=data, headers=headers)
12
13
if response.status_code == 200:
14
print("Image without background:", response.json()["Output_image"])
15
else:
16
print("Error:", response.status_code, response.text)

3. درخواست با استفاده از جاوااسکریپت (با استفاده از Fetch API)

برای ارسال درخواست به API با استفاده از پایتون، می‌توانید از کتابخانه requests استفاده کنید:

1
const url = 'https://api.lumma.ai/v1/remove-background';
2
const headers = {
3
'Content-Type': 'application/json'
4
};
5
6
const data = {
7
"Input_image": "https://example.com/image_to_remove_background.jpg"
8
};
9
10
fetch(url, {
11
method: 'POST',
12
headers: headers,
13
body: JSON.stringify(data)
14
})
15
.then(response => response.json())
16
.then(data => {
17
console.log("Image without background:", data.Output_image);
18
})
19
.catch(error => {
20
console.error("Error:", error);
21
});

ساخت تصویر مشابه

API پیدا کردن تصاویر مشابه به شما این امکان را می‌دهد که تصاویر مشابه به یک تصویر مرجع را بسازید.

پارامترهای ورودی:

1. Input_image(لینک عمومی به تصویر که مطابق با شرایط استفاده ما باشد)

2. Similarity(سطح شباهت بین تصویر ورودی و تصاویری که می‌خواهید پیدا کنید):

• Identical • Changed • Creative

3. Hijab(در صورتی که نیاز به تصویر با حجاب باشد):

• ture • false

پارامترهای خروجی:

1. Output_image(لینک به تصویر تولید شده)

مثال‌های درخواست API در زبان‌های مختلف:

1. درخواست با استفاده از CURL

در اینجا یک درخواست با استفاده از CURL برای ارسال داده‌ها به API آورده شده است:

1
curl -X POST https://api.lumma.ai/v1/text-to-image \
2
-H "Content-Type: application/json" \
3
-d '{ "Input_image": "https://example.com/reference_image.jpg", "Similarity": "Changed", "Hijab": "No" }'

2. درخواست با استفاده از پایتون

برای ارسال درخواست به API با استفاده از پایتون، می‌توانید از کتابخانه requests استفاده کنید:

1
import requests
2
3
url = "https://api.lumma.ai/v1/similar-image"
4
headers = {
5
"Content-Type": "application/json"
6
}
7
data = {
8
"Input_image": "https://example.com/reference_image.jpg",
9
"Similarity": "Changed",
10
"Hijab": "No"
11
}
12
13
response = requests.post(url, json=data, headers=headers)
14
15
if response.status_code == 200:
16
print("Similar Image URL:", response.json()["Output_image"])
17
else:
18
print("Error:", response.status_code, response.text)

3. درخواست با استفاده از جاوااسکریپت (با استفاده از Fetch API)

برای ارسال درخواست به API با استفاده از پایتون، می‌توانید از کتابخانه requests استفاده کنید:

1
const url = 'https://api.lumma.ai/v1/similar-image';
2
const headers = {
3
'Content-Type': 'application/json'
4
};
5
6
const data = {
7
"Input_image": "https://example.com/reference_image.jpg",
8
"Similarity": "Changed",
9
"Hijab": "No"
10
};
11
12
fetch(url, {
13
method: 'POST',
14
headers: headers,
15
body: JSON.stringify(data)

پوشاندن لباس

این بخش از API برای ایجاد تصاویر پوشاندن لباس طراحی شده است. شما می‌توانید با ارسال تصویر لباس و انتخاب پارامترهای مناسب، تصویری با کیفیت و دقیق مطابق با درخواست خود دریافت کنید.

پارامترهای ورودی:

1. Input_image(لینک عمومی به تصویر که مطابق با شرایط استفاده ما باشد)

2. input_garment_type(نوع لباس مانند بالاپوش، پایین‌پوش یا کامل):

• upper_body • lower_body • full_body

3. input_garment_quality(عددی بین 1 تا 100 برای تعیین کیفیت تصویر خروجی)

4. input_garment_gender(جنسیت و گروه سنی کاربر هدف):

• man • women • boy • girl

5. Hijab(در صورتی که نیاز به تصویر با حجاب باشد):

• ture • false

پارامترهای خروجی:

1. Output_image(لینک به تصویر تولید شده)

مثال‌های درخواست API در زبان‌های مختلف:

1. درخواست با استفاده از CURL

در اینجا یک درخواست با استفاده از CURL برای ارسال داده‌ها به API آورده شده است:

1
curl -X POST "https://your-api-endpoint.com/apply-clothing" \
2
-H "Content-Type: application/json" \
3
-d '{
4
"input_garment": "https://example.com/images/garment.jpg",
5
"input_garment_type": "upper_body",
6
"input_garment_quality": 50,
7
"input_garment_gender": "women"
8
}'

2. درخواست با استفاده از پایتون

برای ارسال درخواست به API با استفاده از پایتون، می‌توانید از کتابخانه requests استفاده کنید:

1
import requests
2
3
url = "https://your-api-endpoint.com/apply-clothing"
4
payload = {
5
"input_garment": "https://example.com/images/garment.jpg",
6
"input_garment_type": "upper_body",
7
"input_garment_quality": 50,
8
"input_garment_gender": "women"
9
}
10
headers = {"Content-Type": "application/json"}
11
12
response = requests.post(url, json=payload, headers=headers)
13
print(response.json())

3. درخواست با استفاده از جاوااسکریپت (با استفاده از Fetch API)

برای ارسال درخواست به API با استفاده از پایتون، می‌توانید از کتابخانه requests استفاده کنید:

1
const url = "https://your-api-endpoint.com/apply-clothing";
2
3
const payload = {
4
input_garment: "https://example.com/images/garment.jpg",
5
input_garment_type: "upper_body",
6
input_garment_quality: 50,
7
input_garment_gender: "women"
8
};
9
10
fetch(url, {
11
method: "POST",
12
headers: { "Content-Type": "application/json" },
13
body: JSON.stringify(payload)
14
})
15
.then(response => response.json())
16
.then(data => console.log(data))
17
.catch(error => console.error("Error:", error));