به مستندات رسمی 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 آورده شده است:
1curl -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 استفاده کنید:
1import requests23url = "https://api.lumma.ai/v1/text-to-image"4headers = {5"Content-Type": "application/json"6}7data = {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}1516response = requests.post(url, json=data, headers=headers)1718if response.status_code == 200:19print("Image URL:", response.json()["Output_image"])20else:21print("Error:", response.status_code, response.text)
3. درخواست با استفاده از جاوااسکریپت (با استفاده از Fetch API)
برای ارسال درخواست به API با استفاده از پایتون، میتوانید از کتابخانه requests استفاده کنید:
1const url = 'https://api.lumma.ai/v1/text-to-image';2const headers = {3'Content-Type': 'application/json'4};56const 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};1415fetch(url, {16method: 'POST',17headers: headers,18body: JSON.stringify(data)19})20.then(response => response.json())21.then(data => {22console.log("Image URL:", data.Output_image);23})24.catch(error => {25console.error("Error:", error);26});
API حذف پسزمینه به شما این امکان را میدهد که پسزمینه تصویر را حذف کنید و تنها سوژه اصلی تصویر باقی بماند.
1. Input_image(لینک عمومی به تصویر که مطابق با شرایط استفاده ما باشد)
1. Output_image(لینک به تصویر تولید شده)
مثالهای درخواست API در زبانهای مختلف:
1. درخواست با استفاده از CURL
در اینجا یک درخواست با استفاده از CURL برای ارسال دادهها به API آورده شده است:
1curl -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 استفاده کنید:
1import requests23url = "https://api.lumma.ai/v1/remove-background"4headers = {5"Content-Type": "application/json"6}7data = {8"Input_image": "https://example.com/image_to_remove_background.jpg"9}1011response = requests.post(url, json=data, headers=headers)1213if response.status_code == 200:14print("Image without background:", response.json()["Output_image"])15else:16print("Error:", response.status_code, response.text)
3. درخواست با استفاده از جاوااسکریپت (با استفاده از Fetch API)
برای ارسال درخواست به API با استفاده از پایتون، میتوانید از کتابخانه requests استفاده کنید:
1const url = 'https://api.lumma.ai/v1/remove-background';2const headers = {3'Content-Type': 'application/json'4};56const data = {7"Input_image": "https://example.com/image_to_remove_background.jpg"8};910fetch(url, {11method: 'POST',12headers: headers,13body: JSON.stringify(data)14})15.then(response => response.json())16.then(data => {17console.log("Image without background:", data.Output_image);18})19.catch(error => {20console.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 آورده شده است:
1curl -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 استفاده کنید:
1import requests23url = "https://api.lumma.ai/v1/similar-image"4headers = {5"Content-Type": "application/json"6}7data = {8"Input_image": "https://example.com/reference_image.jpg",9"Similarity": "Changed",10"Hijab": "No"11}1213response = requests.post(url, json=data, headers=headers)1415if response.status_code == 200:16print("Similar Image URL:", response.json()["Output_image"])17else:18print("Error:", response.status_code, response.text)
3. درخواست با استفاده از جاوااسکریپت (با استفاده از Fetch API)
برای ارسال درخواست به API با استفاده از پایتون، میتوانید از کتابخانه requests استفاده کنید:
1const url = 'https://api.lumma.ai/v1/similar-image';2const headers = {3'Content-Type': 'application/json'4};56const data = {7"Input_image": "https://example.com/reference_image.jpg",8"Similarity": "Changed",9"Hijab": "No"10};1112fetch(url, {13method: 'POST',14headers: headers,15body: 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 آورده شده است:
1curl -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 استفاده کنید:
1import requests23url = "https://your-api-endpoint.com/apply-clothing"4payload = {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}10headers = {"Content-Type": "application/json"}1112response = requests.post(url, json=payload, headers=headers)13print(response.json())
3. درخواست با استفاده از جاوااسکریپت (با استفاده از Fetch API)
برای ارسال درخواست به API با استفاده از پایتون، میتوانید از کتابخانه requests استفاده کنید:
1const url = "https://your-api-endpoint.com/apply-clothing";23const payload = {4input_garment: "https://example.com/images/garment.jpg",5input_garment_type: "upper_body",6input_garment_quality: 50,7input_garment_gender: "women"8};910fetch(url, {11method: "POST",12headers: { "Content-Type": "application/json" },13body: JSON.stringify(payload)14})15.then(response => response.json())16.then(data => console.log(data))17.catch(error => console.error("Error:", error));