FLUX 3 Image చిత్ర ప్రాంప్ట్‌లో భాగంగా దీర్ఘచతురస్రాలను ఉపయోగించి, ఒక్కో అంశం ఎక్కడ ఉండాలో వివరించడానికి వీలు కల్పిస్తుంది. రిఫరెన్స్ చిత్రాన్ని సవరించేటప్పుడూ ఇదే విధానాన్ని ఉపయోగించవచ్చు: ప్రతి అంశానికి మూల స్థానం, గమ్య స్థానం, ఏ మార్పు చేయాలో వివరణ ఇవ్వవచ్చు. Black Forest Labs ఈ ఇమేజ్ ఎండ్‌పాయింట్‌ను తన 2026 అక్టోబర్ 1 విడుదల గమనికల్లో.
డిజైనర్లు, సృష్టికర్తలకు ముఖ్యమైన తేడా—మొత్తం కూర్పును ముందే ప్రణాళిక చేయడమా, ఇప్పటికే ఉన్న చిత్రంలోని ఒక అంశాన్ని మార్చడమా అన్నది. ఈ మార్గదర్శి ఆ రెండింటిలో ఏది ఎంచుకోవాలి, దీర్ఘచతురస్రాన్ని అవసరమైన కోఆర్డినేట్లుగా ఎలా మార్చాలి, API ఫలితాన్ని ఎలా పొందాలి వివరిస్తుంది. ఇది 2026 అక్టోబర్ 3న పరిశీలించిన డాక్యుమెంటేషన్ ఆధారిత మార్గదర్శి మాత్రమే. BIG CHANGE ఈ ఉత్పత్తితో చిత్రాన్ని రూపొందించలేదు లేదా సవరించలేదు.
పెద్ద మార్పు
- ఏమి మారింది: BFL అక్టోబర్ 1న విడుదల చేసిన గమనికలు కూర్పు, సవరణల కోసం
v1/flux-3-image. ఒకే ప్రాంప్ట్‌లో దృశ్య వివరణ, JSON అంశాల పట్టిక ఉంటాయి; ఏ అంశాల స్థానాలను నిర్దేశించాలో లేదా ఏవి సవరించాలో బాక్స్‌లు సూచిస్తాయి. BFL విడుదల గమనికలు - ఎందుకు ముఖ్యం: సృష్టికర్తలు ప్రణాళిక చేసిన దీర్ఘచతురస్రాన్ని కోఆర్డినేట్లుగా మార్చి, రిఫరెన్స్‌లోని ఏ అంశాలను అలాగే ఉంచాలి, తరలించాలి లేదా మార్చాలి అని పేర్కొనవచ్చు. ఎంత వివరించాలనేది ఆచరణాత్మక ఎంపిక: మొత్తం కూర్పా, సరళమైన సూచనా, లేక స్పష్టమైన సవరణ పట్టికా అన్నది. BFL బాక్స్ ట్యుటోరియల్
- ఏమి గమనించాలి: పంపే ముందు రిజల్యూషన్, బడ్జెట్ ఎంచుకోండి: జాబితాలోని
1kమరియు4kధరలు ఒక్కో చిత్రానికి వరుసగా $0.048, $0.607. బాక్స్‌ల వెలుపలకూ అంశాలు విస్తరించవచ్చు; సవరణ వల్ల పక్కనున్న వెలుతురు, నీడలు లేదా ప్రతిబింబాలు మారవచ్చు కాబట్టి పూర్తి ఫలితాన్ని పరిశీలించండి. BFL ధరల జాబితా, సవరణ పరిమితులు
బ్రౌజర్ లేదా API మార్గాన్ని ఎంచుకోండి
BFL ఉత్పత్తి పేజీ రెండు ప్రారంభ మార్గాలను వివరిస్తుంది: బ్రౌజర్‌లోని Playgroundలో బాక్స్‌లు గీయడం లేదా API ద్వారా లేఅవుట్ ప్రాంప్ట్ పంపడం. కోడ్ లేకుండా ఉపయోగించేందుకు Playgroundకు డాక్యుమెంటేషన్ లింక్ ఇస్తుంది . ప్రాంతాలను నేరుగా గీయాలనుకుంటే బ్రౌజర్ మార్గాన్ని ఎంచుకోండి; అభ్యర్థనలో కోఆర్డినేట్లు ఇచ్చి ఫలితాన్ని ప్రోగ్రామాటిక్‌గా పొందాలంటే APIని ఉపయోగించండి. ప్రస్తుతం Playground నియంత్రణలను మేము పరిశీలించలేదు; కాబట్టి దిగువ సూచనలు బ్రౌజర్ బటన్‌ల క్రమాన్ని కాక, డాక్యుమెంట్ చేసిన అభ్యర్థన రూపాన్ని వివరిస్తాయి.
API కోసం BFL ఖాతా తెరిచి, క్రెడిట్‌లు జోడించి, డాష్‌బోర్డ్ నుంచి కీ పొందండి. JSONలో POST అభ్యర్థనను https://api.bfl.ai/v1/flux-3-image కు పంపండి; Content-Type: application/json ను, కీని x-key హెడర్‌లో చేర్చండి. prompt మాత్రమే తప్పనిసరి. BFL జనరేషన్ మార్గదర్శి, ధరలు, సెటప్
FLUX 3 Image, FLUX 3 Devలను వేరుగా గుర్తించాలి: ఈ సూచనలు BFL హోస్ట్ చేసే Image ఎండ్‌పాయింట్‌కు వర్తిస్తాయి. Image ఉత్పత్తి పేజీ విక్రయ విభాగం ద్వారా వాణిజ్య వెయిట్స్ లైసెన్స్‌ను అందిస్తుంది. ఈ మార్గదర్శి కోసం పరిశీలించిన మూలాలు FLUX 3 Imageకు ఓపెన్-వెయిట్ డౌన్‌లోడ్ ఉందని నిర్ధారించవు. FLUX 3 Image ప్రాప్యత
చిత్రంలో ఎంత భాగాన్ని నిర్దేశించాలో నిర్ణయించండి
పని | డాక్యుమెంట్ చేసిన ఇన్‌పుట్ | ఉపయోగించాల్సిన నియంత్రణ |
|---|---|---|
కొత్త కూర్పును రూపొందించడం | ఐచ్ఛికంగా అంశాల పట్టికను అనుసరించే దృశ్య ప్రాంప్ట్ | |
గుర్తించగలిగే వివరాన్ని మార్చడం | ఒక సూచన, ఒక రిఫరెన్స్ చిత్రం | ఖచ్చితమైన వివరణ సరిపోవచ్చు; విస్తరించిన ప్రాంప్ట్‌ను పరిశీలించండి |
ఏ అంశాలను సవరించాలో ఖచ్చితంగా ఎంచుకోవడం | ఒక సూచన, రిఫరెన్స్ చిత్రం, సవరణ పట్టిక | ఉంచాల్సిన అంశాల కోసం మూల, గమ్య బాక్స్‌లు; అలాగే ఉంచే వరుసలు |
రిఫరెన్స్ చిత్రాలను కలపడం | వాటి పాత్రలను వివరించే ప్రాంప్ట్, 2 నుంచి 10 చిత్రాలు | ఏ వస్తువు, విషయం లేదా నేపథ్యానికి ఏ చిత్రం ఆధారమో గుర్తించండి |
సరళమైన సవరణలో ప్రాంప్ట్ విస్తరణ దశలో బాక్స్ స్వయంచాలకంగా పొందవచ్చని BFL చెబుతోంది. స్పష్టమైన నియంత్రణ కావాలంటే మీ పట్టికను అందించండి. సాధారణ సూచనల్లో “image 1” అంటే మొదటి రిఫరెన్స్; సవరణ వరుసల్లో అదే రిఫరెన్స్ ref_image_0. BFL సవరణ మార్గదర్శి
రిఫరెన్స్ చిత్రాలను images లో URLలుగా లేదా base64 డేటాగా—ఒక స్ట్రింగ్‌గా లేదా జాబితాగా—ఇవ్వాలి. ఇచ్చినప్పుడు 1 నుంచి 10 చిత్రాలు ఉండవచ్చు; ఒక్కోటి 256 × 256 పిక్సెల్‌ల నుంచి 16 మెగాపిక్సెల్‌ల వరకు ఉండాలి. డిఫాల్ట్ aspect_ratio అనేది auto: అది మొదటి రిఫరెన్స్ పరిమాణాన్ని అనుసరిస్తుంది; రిఫరెన్స్ ఇవ్వకపోతే చతురస్ర ఫలితాన్ని ఉత్పత్తి చేస్తుంది. మీ లేఅవుట్‌కు నిర్దిష్ట ఆకారం అవసరమైతే దీన్ని స్పష్టంగా సెట్ చేయండి. BFL ఎండ్‌పాయింట్ అవలోకనం
దీర్ఘచతురస్రాన్ని బాక్స్‌గా మార్చండి
ప్రతి బాక్స్ [top, left, bottom, right] రూపంలో ఉంటుంది; కోఆర్డినేట్లు 0 నుంచి 1000 వరకు పూర్ణసంఖ్యలు. ముందుగా నిలువు కోఆర్డినేట్లు వస్తాయి. ఒక్కో అక్షం మొత్తం చిత్రాన్ని స్వతంత్రంగా విస్తరిస్తుంది; అందువల్ల గ్రిడ్ ల్యాండ్‌స్కేప్ లేదా పోర్ట్రెయిట్ కాన్వాస్‌కు సరిపోయేలా సాగుతుంది. BFL బాక్స్ రూపం
పిక్సెల్ స్థానాలను మార్చడానికి, పై, కింది స్థానాలను చిత్ర ఎత్తుతో; ఎడమ, కుడి స్థానాలను దాని వెడల్పుతో భాగించండి. వచ్చిన ప్రతి ఫలితాన్ని 1000తో గుణించి, సమీప పూర్ణసంఖ్యకు రౌండ్ చేయండి. BFL డాక్యుమెంట్ చేసిన మార్పిడి 1920 × 1080 కాన్వాస్‌ను ఉపయోగిస్తుంది:
అంచు | పిక్సెల్ స్థానం | లెక్కింపు | గ్రిడ్ విలువ |
|---|---|---|---|
పై అంచు | 108 | 108 ÷ 1080 × 1000 | 100 |
ఎడమ అంచు | 384 | 384 ÷ 1920 × 1000 | 200 |
కింది అంచు | 972 | 972 ÷ 1080 × 1000 | 900 |
కుడి అంచు | 1536 | 1536 ÷ 1920 × 1000 | 800 |
కాబట్టి బాక్స్ [100, 200, 900, 800] అవుతుంది. దాని నిలువు పరిధి ఫ్రేమ్‌లో 10% నుంచి 90% వరకు; అడ్డంగా 20% నుంచి 80% వరకు ఉంటుంది. వెడల్పు, ఎత్తును తారుమారు చేయడం లేదా ఎడమ కోఆర్డినేటును పై కోఆర్డినేటుకంటే ముందు ఇవ్వడం వల్ల ఉద్దేశించిన ప్రాంతం ఎలా మారుతుందో ఈ లెక్క వివరిస్తుంది. లేఅవుట్‌ను రూపొందించినప్పుడు ఉపయోగించిన ఆకార నిష్పత్తిని అలాగే ఉంచండి. BFL కోఆర్డినేట్ మార్పిడి
కొత్త చిత్రాన్ని కూర్చండి
మొత్తం కూర్పును వివరించి, అంశాలకు <id> గుర్తులు పెట్టండి; ప్రతి అంశానికి సంబంధించిన JSON శ్రేణిని జోడించండి, అందులో id, bbox మరియు desc ప్రతి అంశానికి. ఈ శ్రేణి ప్రాంప్ట్‌లోని వచనంగా prompt, మరో ఉన్నత-స్థాయి API ఫీల్డ్‌గా కాదు.
BFL డాక్యుమెంట్ చేసిన పరుగెత్తే ఆకృతి ఉదాహరణలో నేపథ్యం కాన్వాస్ అంతా కప్పి, బొమ్మ మధ్య బాక్స్‌లో ఉంటుంది. ఈ సంక్షిప్త అభ్యర్థన ఆ లేఅవుట్‌ను అనుసరిస్తుంది; BIG CHANGE దీన్ని అమలు చేయలేదు:
{
"prompt": "A black running silhouette <silhouette_1> on a chartreuse background <background_1>. [{\"id\":\"background_1\",\"bbox\":[0,0,1000,1000],\"desc\":\"Chartreuse background with paper texture\"},{\"id\":\"silhouette_1\",\"bbox\":[150,150,850,850],\"desc\":\"Black running silhouette with stippled texture\"}]",
"aspect_ratio": "1:1",
"resolution": "1k"
}వచనం ఉన్న లేఅవుట్‌లో ప్రతి పంక్తికి ప్రత్యేక వరుస ఇవ్వండి; కోరిన ఖచ్చితమైన పదాలను descలో ఉంచండి. బాక్స్‌లు స్థానాన్ని, పరిమాణాన్ని సూచిస్తాయి; ఒక అంశం తన దీర్ఘచతురస్రం వెలుపలకూ విస్తరించవచ్చని BFL హెచ్చరిస్తుంది. ఇవి గట్టి క్లిప్పింగ్ మాస్క్‌లు కావు. BFL కూర్పు ట్యుటోరియల్, పరిమితులు
ఇప్పటికే ఉన్న చిత్రాన్ని సవరించండి
మూల చిత్రాన్ని imagesలో ఇవ్వండి. సవరణ వరుసల్లో id మరియు desc అలాగే ఉంచి, bbox కింది ఫీల్డ్‌లతో భర్తీ చేయండి:
చర్య | | | |
|---|---|---|---|
అంశాన్ని అలాగే ఉంచండి | | దాని మూల బాక్స్ | అదే బాక్స్ |
దాన్ని తరలించండి లేదా పరిమాణం మార్చండి | | దాని మూల బాక్స్ | వేరే గమ్య బాక్స్ |
జోడించండి, భర్తీ చేయండి లేదా రంగు మార్చండి | | | కావలసిన అవుట్‌పుట్ బాక్స్ |
దాన్ని తొలగించండి | | దాని మూల బాక్స్ | |
సూచనను, సవరణల శ్రేణిని కూర్పు విధానంలాగే promptలో కలపండి. జోడింపులు, తొలగింపులను రెండుచోట్లా వివరించండి. అలాగే ఉండాల్సిన అంశాలకు keep వరుసలు జోడించండి. బాక్స్‌ల వెలుపలి పిక్సెల్‌లు సాధారణంగా మారవని BFL మార్గదర్శి చెబుతుంది; అయితే సమీపంలోని వెలుతురు, ప్రతిబింబాలు, నీడలు మారవచ్చు. సవరణను ఆమోదించే ముందు మొత్తం ఫలితాన్ని మూల చిత్రంతో పోల్చండి. తన పరీక్షల్లో సుమారు 40 × 25 పిక్సెల్‌ల బాక్స్‌లలో కొత్త అంశాలు తరచూ కనిపించలేదని BFL నివేదించింది; ఇది విక్రేత పరిశీలన మాత్రమే, అందరికీ వర్తించే కనీస పరిమాణమో BIG CHANGE పరీక్ష ఫలితమో కాదు. BFL సవరణ మార్గదర్శి, సవరణ వరుసల నిర్మాణం
రిజల్యూషన్, బడ్జెట్‌ను ఎంచుకోండి
అవలోకనంలో 768sq, 1k, 1.5k, 2k మరియు 4k ఉన్నాయి; అందులో 1k డిఫాల్ట్. ధరల పేజీ కింది రేట్లను ప్రచురిస్తుంది; అయితే 1.5k ధరను పేర్కొనలేదు. ఆ ఎంపికను ఉపయోగించే ముందు దాని ఖర్చును తనిఖీ చేయండి. BFL అవలోకనం
రిజల్యూషన్ | డాక్యుమెంట్ చేసిన అవుట్‌పుట్ పరిమాణం | ఒక్కో చిత్రానికి ధర | పది అభ్యర్థనల లెక్కించిన ఖర్చు |
|---|---|---|---|
| 768 × 768 | $0.041 | $0.41 |
| సుమారు 1 మెగాపిక్సెల్ | $0.048 | $0.48 |
| సుమారు 4 మెగాపిక్సెల్‌లు | $0.100 | $1.00 |
| సుమారు 16 మెగాపిక్సెల్‌లు | $0.607 | $6.07 |
ఇవి అక్టోబర్ 3న తనిఖీ చేసిన BFL జాబితా ధరలు, US డాలర్లలో. పది అభ్యర్థనల కాలమ్ లెక్క మాత్రమే; వాస్తవ ఖర్చు కొలత కాదు. API, Playground రెండింటికీ BFL ఒకే ధరను పేర్కొంటుంది; ఒక క్రెడిట్ విలువ $0.01. అభ్యర్థన ప్రతిస్పందనలో cost. ఒక 4k అభ్యర్థనకు, 1k ధరతో పోలిస్తే సుమారు 12.6 రెట్లు ఖర్చవుతుంది; మీ పనికి అవసరమైన అవుట్‌పుట్ పరిమాణాన్ని ఎంచుకుని, అదనపు ప్రయత్నాలకూ బడ్జెట్ కేటాయించండి. రిజల్యూషన్ మార్చడం కొత్త అభ్యర్థన; రెండు అభ్యర్థనలు ఒకే కూర్పును ఇస్తాయని ఈ మార్గదర్శి నిర్ధారించదు. BFL ధరల జాబితా
ఐచ్ఛికమైన grounding సెట్టింగ్ డిఫాల్ట్‌గా trueగా ఉంటుంది; ఇది రూపొందించడానికి ముందు వెబ్, ఇమేజ్ శోధనను ప్రారంభిస్తుంది. దీన్ని ఆపితే ప్రాంప్ట్ మాత్రమే ఉపయోగించి వేగంగా ఫలితాలు వస్తాయని BFL చెబుతోంది. ఆ వేగ వ్యత్యాసాన్ని మేము కొలవలేదు; ఆధారాలతో రూపొందించిన ఫలితాల ఖచ్చితత్వాన్నీ ధృవీకరించలేదు. BFL ఆధారాల డాక్యుమెంటేషన్
ఫలితాన్ని పంపండి, స్థితి అడిగి, భద్రపరచండి
అభ్యర్థన పంపిన తర్వాత తిరిగి వచ్చిన polling_url ను భద్రపరచి, మీ API కీతో అదే URL స్థితిని అడగండి. ఆ URL పని జరుగుతున్న ప్రాంతాన్ని సూచిస్తుంది. Pending, Reasoning మరియు Generating అంటే పని ఇంకా కొనసాగుతోంది. Ready స్థితిలో result.sampleను డౌన్‌లోడ్ చేయండి; దాని సంతకం చేసిన లింక్ గంట తర్వాత గడువు ముగుస్తుంది. మీ x-key హెడర్‌ను డౌన్‌లోడ్ URLకు పంపవద్దు. ఫలితంలో విస్తరించిన సూచనను చూపించే result.prompt, అలాగే రూపొందించిన సమయాన్ని చూపించే result.duration కూడా ఉంటాయి. BFL ఫలితాన్ని పొందే సూచనలు
నిరోధించబడిన లేదా విఫలమైన పనికి, ఇంకా నడుస్తున్న పనికంటే వేరే చర్య అవసరం. Request Moderated అంటే ఇన్‌పుట్ నిరోధించబడింది; Content Moderated అంటే అవుట్‌పుట్ నిరోధించబడింది. మరోసారి ప్రయత్నించే ముందు ఇన్‌పుట్‌ను సవరించండి. Error అయితే ప్రతిస్పందనను పరిశీలించండి; తెలియని లేదా గడువు ముగిసిన పనికి Task not found తిరిగి వస్తుంది. BFL హెచ్చరిక ప్రకారం, విఫలమైన పని సాధారణ JSON బాడీతో HTTP 503 తో రావచ్చు; కాబట్టి మళ్లీ ప్రయత్నించే ముందు దాని status ను చదవండి. పరిమితిని మించిన రిఫరెన్స్‌లు 400 ఇస్తాయి; తెలియని ఫీల్డ్, చెల్లని విలువ, ఖాళీ ప్రాంప్ట్ లేదా పరిమాణం తక్కువైన చిత్రం 422 ఇవ్వవచ్చు. ఇతర ఎండ్‌పాయింట్లకు చెందిన seed, width మరియు input_image వంటి ఫీల్డ్‌లు ఇక్కడ అంగీకరించబడవు. BFL జనరేషన్, లోపాల మార్గదర్శి
ఫలితాన్ని భద్రపరచి, దాని స్థానం, కోరిన వచనం, సవరణ చుట్టుపక్కల ప్రాంతాలను పరిశీలించినప్పుడే ప్రయత్నం పూర్తవుతుంది. Ready ప్రతిస్పందన ఫలితం అందుబాటులో ఉందని నిర్ధారిస్తుంది; అది పనికి సరిపోతుందో మీ దృశ్య సమీక్షే నిర్ణయిస్తుంది.
మూలాలు, మరింత చదవడానికి
- FLUX 3 Image ఉత్పత్తి పేజీ: బ్రౌజర్/API మార్గాలు, వాణిజ్య వెయిట్స్ ప్రాప్యతను నిర్ధారిస్తుంది. దాని ప్రదర్శనలు విక్రేత అందించినవి; మా పరీక్ష ఫలితాలు కావు.
- అక్టోబర్ 1 విడుదల గమనికలు: ఇమేజ్ విడుదల తేదీ, భాగస్వామ్య ఎండ్‌పాయింట్‌ను వివరిస్తాయి. విస్తృత నియంత్రణ వాదనలను ట్యుటోరియల్‌లలోని నిర్దిష్ట పరిమితులతో కలిపి చదవాలి.
- ఎండ్‌పాయింట్ అవలోకనం: పారామీటర్లు, రిఫరెన్స్ పరిమితులు, రిజల్యూషన్ ఎంపికలు, ఆధారాల ప్రవర్తనను అందిస్తుంది.
- బౌండింగ్ బాక్స్ ట్యుటోరియల్: రెండు వరుసల నిర్మాణాలను, ఇక్కడ మార్చి ఉపయోగించిన పరుగెత్తే ఆకృతి ఉదాహరణను వివరిస్తుంది.
- సవరణ మార్గదర్శి: కోఆర్డినేట్ మార్పిడి, రిఫరెన్స్ క్రమం, చిన్న ప్రాంతాలు, చుట్టుపక్కల పిక్సెల్‌లపై హెచ్చరికలకు ఆధారమిస్తుంది.
- జనరేషన్ మార్గదర్శి: ధృవీకరణ, అసమకాలిక ఫలితాల పొందడం, గడువు ముగిసే లింక్‌లు, లోపాలను వివరిస్తుంది.
- ధరలు: మా లెక్కలో ఉపయోగించిన రేట్లను అందిస్తుంది. ప్రయత్నానికి చెల్లించే ముందు ధరలు, అభ్యర్థన పారామీటర్లను మళ్లీ తనిఖీ చేయండి; ఇవి మారే లైవ్ పత్రాలు.
