Image Translation(Image) API
- ์ด๋ฏธ์ง ์์ ํ
์คํธ๋ฅผ ์ธ์ํ๊ณ ์ถ์ถ(OCR) ํ์ฌ, ๋ฒ์ญ ํ
์คํธ ๋ฐ ๋ฒ์ญ ์ด๋ฏธ์ง ์ ๊ณต
- ์์ค ์ธ์ด๋ฅผ ์ง์ ํ์ง ์์๋ Translation API์์ ์๋์ผ๋ก ์ธ์ด๋ฅผ ๊ฐ์งํ์ฌ ๋ฒ์ญ ๊ฒฐ๊ณผ๋ฅผ ์ ๊ณต. ์ด ๊ฒฝ์ฐ, ์ธ์ด ๊ฐ์ง์ ์ถ๊ฐ ๊ณผ๊ธ์ ํ์ง ์๊ณ , ๋ฒ์ญ ์์ฒญ ๊ธ์์ ๊ธฐ์ค์ผ๋ก๋ง ๊ณผ๊ธ
API URL
Method |
์์ฒญ URL |
์ถ๋ ฅ ํฌ๋งท |
POST |
https://papago.apigw-pub.fin-ntruss.com/v1/translate |
JSON |
Header
Name |
Description |
Content-Type |
multipart/form-data ํ์์ผ๋ก ์ ์ก ํ์ |
X-NCP-APIGW-API-KEY-ID |
NCP ์ฑ ๋ฑ๋ก ์ ๋ฐ๊ธ๋ฐ์ Client ID |
X-NCP-APIGW-API-KEY |
NCP ์ฑ ๋ฑ๋ก ์ ๋ฐ๊ธ๋ฐ์ Secret Key |
Parameter
Name |
Type |
Required |
Description |
source |
String |
true |
์๋ฌธ ์ธ์ด ์ฝ๋ auto๋ก ์ค์ ์, ์๋์ผ๋ก ์์ค ์ธ์ด๋ฅผ ๊ฐ์ง |
target |
String |
true |
๋ฒ์ญ ์ธ์ด ์ฝ๋ |
image |
File |
true |
์๋ณธ ์ด๋ฏธ์ง ํ์ผ |
์ง์ ์ธ์ด
์์ค ์ธ์ด - ํ๊ตญ์ด, ์์ด, ์ผ๋ณธ์ด, ์ค๊ตญ์ด ๊ฐ์ฒด, ์ค๊ตญ์ด ๋ฒ์ฒด, ๋ฒ ํธ๋จ์ด, ํ๊ตญ์ด, ์ธ๋๋ค์์์ด, ํ๋์ค์ด, ์คํ์ธ์ด, ๋ฌ์์์ด
ํ๊ฒ ์ธ์ด - ํ๊ตญ์ด, ์์ด, ์ผ๋ณธ์ด, ์ค๊ตญ์ด ๊ฐ์ฒด, ์ค๊ตญ์ด ๋ฒ์ฒด, ๋ฒ ํธ๋จ์ด, ํ๊ตญ์ด, ์ธ๋๋ค์์์ด, ํ๋์ค์ด, ์คํ์ธ์ด, ๋ฌ์์์ด, ๋
์ผ์ด, ์ดํ๋ฆฌ์์ด
์ธ์ด |
์ธ์ด ์ฝ๋ |
ํ๊ตญ์ด |
ko |
์์ด |
en |
์ผ๋ณธ์ด |
ja |
์ค๊ตญ์ด ๊ฐ์ฒด |
zh-CN |
์ค๊ตญ์ด ๋ฒ์ฒด |
zh-TW |
๋ฒ ํธ๋จ์ด |
vi |
ํ๊ตญ์ด |
th |
์ธ๋๋ค์์์ด |
id |
ํ๋์ค์ด |
fr |
์คํ์ธ์ด |
es |
๋ฌ์์์ด |
ru |
๋
์ผ์ด |
de |
์ดํ๋ฆฌ์์ด |
it |
Response
Json ํ์์ผ๋ก ๋ฆฌํด
Field Name |
Type |
Description |
data |
JSON Object |
|
data.sourceLang |
String |
์๋ฌธ ์ธ์ด ์ฝ๋ |
data.targetLang |
String |
๋ฒ์ญ ์ธ์ด ์ฝ๋ |
data.sourceText |
String |
์๋ฌธ ํ
์คํธ |
data.targetText |
String |
๋ฒ์ญ ํ
์คํธ |
data.renderedImage |
String |
๋ฒ์ญ๋ ์ด๋ฏธ์ง ๋ฐ์ด๋๋ฆฌ base64 ์ธ์ฝ๋ฉ |
data.blocks |
JSON Array |
Block๋จ์ OCR ์ ๋ณด |
data.blocks[].sourceLang |
String |
์๋ฌธ ์ธ์ด ์ฝ๋ |
data.blocks[].sourceText |
String |
์๋ฌธ ํ
์คํธ |
data.blocks[].targetText |
String |
๋ฒ์ญ ํ
์คํธ |
data.blocks[].lb |
JSON Object |
Left Bottom์ขํ (x, y ๋ด๋ถ ํ๋ ์กด์ฌ) |
data.blocks[].lt |
JSON Object |
Left Top ์ขํ (x, y ๋ด๋ถ ํ๋ ์กด์ฌ) |
data.blocks[].rb |
JSON Object |
Right Bottom ์ขํ (x, y ๋ด๋ถ ํ๋ ์กด์ฌ) |
data.blocks[].rt |
JSON Object |
Right Top ์ขํ (x, y ๋ด๋ถ ํ๋ ์กด์ฌ) |
data.blocks[].lines |
JSON Array |
Line ๋จ์ OCR ์ ๋ณด |
data.blocks[].lines[].lb |
JSON Object |
Left Bottom์ขํ (x, y ๋ด๋ถ ํ๋ ์กด์ฌ) |
data.blocks[].lines[].lt |
JSON Object |
Left Top ์ขํ (x, y ๋ด๋ถ ํ๋ ์กด์ฌ) |
data.blocks[].lines[].rb |
JSON Object |
Right Bottom ์ขํ (x, y ๋ด๋ถ ํ๋ ์กด์ฌ) |
data.blocks[].lines[].rt |
JSON Object |
Right Top ์ขํ (x, y ๋ด๋ถ ํ๋ ์กด์ฌ) |
data.blocks[].lines[].words |
JSON Array |
Word ๋จ์ OCR ์ ๋ณด |
data.blocks[].lines[].words[].sourceText |
String |
์๋ฌธ ํ
์คํธ |
data.blocks[].lines[].words[].lb |
JSON Object |
Left Bottom์ขํ (x, y ๋ด๋ถ ํ๋ ์กด์ฌ) |
data.blocks[].lines[].words[].lt |
JSON Object |
Left Top ์ขํ (x, y ๋ด๋ถ ํ๋ ์กด์ฌ) |
data.blocks[].lines[].words[].rb |
JSON Object |
Right Bottom ์ขํ (x, y ๋ด๋ถ ํ๋ ์กด์ฌ) |
data.blocks[].lines[].words[].rt |
JSON Object |
Right Top ์ขํ (x, y ๋ด๋ถ ํ๋ ์กด์ฌ) |
CURL Example
$ curl --location --request POST 'https://papago.apigw-pub.fin-ntruss.com/image-to-image/v1/translate' \
-H "X-NCP-APIGW-API-KEY-ID:{์ ํ๋ฆฌ์ผ์ด์
๋ฑ๋ก ์ ๋ฐ๊ธ๋ฐ์ client id๊ฐ}" \
-H "X-NCP-APIGW-API-KEY:{์ ํ๋ฆฌ์ผ์ด์
๋ฑ๋ก ์ ๋ฐ๊ธ๋ฐ์ client secret๊ฐ}" \
--form 'image=@"/Users/user/a.png"' \
--form 'source="ko"' \
--form 'target="en"'
{"data":{"sourceLang":"ko","targetLang":"en","sourceText":"NEW\nGURSKEN\n๊ตฌ๋ฅด์ค์ผ\n์ท์ฅ\n49x55x186 cm\n๋ผ์ดํธ๋ฒ ์ด์ง\nโฉ79,900\nIMEA","targetText":"NEW\nGURSKEN\nGursken.\nCloset\n49x55x186 cm\nLight beige.\nโฉ79,900\nIMEA","blocks":[{"sourceLang":"ko","sourceText":"NEW","targetText":"NEW","lines":[{"lb":{"x":195,"y":29},"lt":{"x":201,"y":2},"rb":{"x":255,"y":42},"rt":{"x":261,"y":15}}],"lb":{"x":195,"y":29},"lt":{"x":200,"y":1},"rb":{"x":255,"y":42},"rt":{"x":261,"y":15}},{"sourceLang":"ko","sourceText":"GURSKEN","targetText":"GURSKEN","lines":[{"lb":{"x":191,"y":118},"lt":{"x":194,"y":92},"rb":{"x":317,"y":135},"rt":{"x":321,"y":108}}],"lb":{"x":190,"y":119},"lt":{"x":194,"y":92},"rb":{"x":317,"y":135},"rt":{"x":321,"y":107}},{"sourceLang":"ko","sourceText":"๊ตฌ๋ฅด์ค์ผ","targetText":"Gursken.","lines":[{"lb":{"x":191,"y":159},"lt":{"x":194,"y":135},"rb":{"x":270,"y":167},"rt":{"x":272,"y":142}}],"lb":{"x":190,"y":159},"lt":{"x":193,"y":134},"rb":{"x":269,"y":167},"rt":{"x":272,"y":142}},{"sourceLang":"ko","sourceText":"์ท์ฅ","targetText":"Closet","lines":[{"lb":{"x":195,"y":207},"lt":{"x":197,"y":177},"rb":{"x":247,"y":211},"rt":{"x":248,"y":180}}],"lb":{"x":194,"y":207},"lt":{"x":197,"y":176},"rb":{"x":247,"y":211},"rt":{"x":249,"y":180}},{"sourceLang":"ko","sourceText":"49x55x186 cm","targetText":"49x55x186 cm","lines":[{"lb":{"x":196,"y":232},"lt":{"x":197,"y":220},"rb":{"x":268,"y":235},"rt":{"x":269,"y":222}}],"lb":{"x":196,"y":232},"lt":{"x":196,"y":218},"rb":{"x":268,"y":235},"rt":{"x":268,"y":222}},{"sourceLang":"ko","sourceText":"๋ผ์ดํธ๋ฒ ์ด์ง","targetText":"Light beige.","lines":[{"lb":{"x":197,"y":252},"lt":{"x":197,"y":237},"rb":{"x":257,"y":252},"rt":{"x":257,"y":237}}],"lb":{"x":197,"y":252},"lt":{"x":197,"y":237},"rb":{"x":257,"y":252},"rt":{"x":257,"y":237}},{"sourceLang":"ko","sourceText":"โฉ79,900","targetText":"โฉ79,900","lines":[{"lb":{"x":223,"y":448},"lt":{"x":219,"y":406},"rb":{"x":358,"y":434},"rt":{"x":354,"y":393}}],"lb":{"x":223,"y":448},"lt":{"x":218,"y":406},"rb":{"x":358,"y":434},"rt":{"x":354,"y":392}},{"sourceLang":"ko","sourceText":"IMEA","targetText":"IMEA","lines":[{"lb":{"x":280,"y":570},"lt":{"x":278,"y":563},"rb":{"x":308,"y":562},"rt":{"x":305,"y":554}}],"lb":{"x":279,"y":570},"lt":{"x":277,"y":561},"rb":{"x":307,"y":562},"rt":{"x":305,"y":553}}],"renderedImage":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAgUEBAMEBgUGBgYFBgYGBwkIBgcJBwYGCAsICQoKCgoKBggLDAsKDAkKCgr/2wBDAQICAgICAgUDAwUKBwYHCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgr/wAARCAJdAcYDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/ /OvXLjSIdC8deIfHkhCwtoiSK+P4sHP/oIrk9YsW+InhvwV4ijO91vFtrkkdMHLf8AoFKrhKcaMqdveu2n5XSHQx9R4iNRv3OVJ+tmzz/4pfC+T4cfYpJdYW4a+
{{ โฆ ์๋ต โฆ }}
LP+KdRMlj8DPhhY6PHghdS1lvtM/1CD5R696+DYmlKndLkDoMVNGxSIEHn1o52tjNts9M+J37Uvx7+NN283xF+Juq6hHI2fspuTHCPYRrhcfUVx0MrZ3eZ7AZrNgZmj8wn8KvW6jdjJ6Z61Lk5biNCCYGPceTjsKuWrNhcjqaz7YFSAD95uavwgAAkZOetImRON24gYx2Hp70FnQZRgB0+tRyylSnyg5FSIokXcexNBS2EUMW3MvB70rqQAU53e1OifeSoXGCQcd6az7cADt60AKrAfKvOT170EEHrwOgNRRHErJjgVYCjcG+tADAHZgRkkdQR2qYpt6Oee4P+c0xg0ZyrnilYltoJ6L1pK6AahGducZPXtXN/CaL/inrkksQNVvAD0/5bviupEaHIxxxx+Nc18K0C6DcIDwNTu8j1/fvWkXpcmR43+0KpX4lTBTn/RYskHpweK53QsbuMcDpjvXRftAuzfEm5JP/AC7xfyNc9oYCtnGau/MiT0HwjsNoVEYzjJ5oqTwRGktpyOdp5z70VIH/2Q\u003d\u003d"}}
Python Example