kakao developers

POST /v2/vision/face/detect HTTP/1.1
Host: dapi.kakao.com
Authorization: KakaoAK {REST_API_KEY}

* 조건부: image/ image_url 중 하나 필수

curl -v -X POST "https://dapi.kakao.com/v2/vision/face/detect" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -H "Authorization: KakaoAK {REST_API_KEY}" \
    --data-urlencode "image_url=https://t1.daumcdn.net/alvolo/_vision/openapi/r2/images/01.jpg" 

curl -v -X POST "https://dapi.kakao.com/v2/vision/face/detect" \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: KakaoAK {REST_API_KEY}" \
    -F "image=@sample_face.jpg" 

POST /v2/vision/product/detect HTTP/1.1
Host: dapi.kakao.com
Authorization: KakaoAK {REST_API_KEY}

* 조건부: image/ image_url 중 하나 필수

curl -v -X POST "https://dapi.kakao.com/v2/vision/product/detect" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -H "Authorization: KakaoAK {REST_API_KEY}" \
    --data-urlencode "image_url=https://t1.daumcdn.net/alvolo/_vision/openapi/r2/images/06.jpg" 

curl -v -X POST "https://dapi.kakao.com/v2/vision/product/detect" \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: KakaoAK {REST_API_KEY}" \
    -F "image=@sample_product.jpg"

POST /v2/vision/adult/detect HTTP/1.1
Host: dapi.kakao.com
Authorization: KakaoAK {REST_API_KEY}

* 조건부: image/ image_url 중 하나 필수

curl -v -X POST "https://dapi.kakao.com/v2/vision/adult/detect" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -H "Authorization: KakaoAK {REST_API_KEY}" \
    --data-urlencode "image_url=https://t1.daumcdn.net/alvolo/_vision/openapi/r2/images/09.jpg" 

curl -v -X POST "https://dapi.kakao.com/v2/vision/adult/detect" \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: KakaoAK {REST_API_KEY}" \
    -F "image=@sample_adult.jpg"

POST /v2/vision/thumbnail/crop HTTP/1.1
Host: dapi.kakao.com
Authorization: KakaoAK {REST_API_KEY}

* 조건부: image/ image_url 중 하나 필수

curl -v -X POST "https://dapi.kakao.com/v2/vision/thumbnail/crop" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -H "Authorization: KakaoAK {REST_API_KEY}" \
    --data-urlencode "image_url=https://t1.daumcdn.net/alvolo/_vision/openapi/r2/images/07.jpg"
    -d "width=200" \
    -d "height=200" 

curl -v -X POST "https://dapi.kakao.com/v2/vision/thumbnail/crop" \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: KakaoAK {REST_API_KEY}" \
    -F "image=@sample_thumbnail.jpg" \
    -F "width=200" \
    -F "height=200" 

POST /v2/vision/thumbnail/detect HTTP/1.1
Host: dapi.kakao.com
Authorization: KakaoAK {REST_API_KEY}

* 조건부: image/ image_url 중 하나 필수

curl -v -X POST "https://dapi.kakao.com/v2/vision/thumbnail/detect" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -H "Authorization: KakaoAK {REST_API_KEY}" \
    --data-urlencode "image_url=https://t1.daumcdn.net/alvolo/_vision/openapi/r2/images/07.jpg" \
    -d "width=200" \
    -d "height=200" 

curl -v -X POST "https://dapi.kakao.com/v2/vision/thumbnail/detect" \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: KakaoAK {REST_API_KEY}" \
    -F "image=@sample_thumbnail.jpg" \
    -F "width=200" \
    -F "height=200" 

POST /v2/vision/multitag/generate HTTP/1.1
Host: dapi.kakao.com
Authorization: KakaoAK {REST_API_KEY}

* 조건부: image/ image_url 중 하나 필수

curl -v -X POST "https://dapi.kakao.com/v2/vision/multitag/generate" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -H "Authorization: KakaoAK {REST_API_KEY}" \
    --data-urlencode "image_url=https://t1.daumcdn.net/alvolo/_vision/openapi/r2/images/08.jpg" 

curl -v -X POST "https://dapi.kakao.com/v2/vision/multitag/generate" \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: KakaoAK {REST_API_KEY}" \
    -F "image=@sample_tag.jpg" 

POST /v2/vision/text/ocr HTTP/1.1
Host: dapi.kakao.com
Authorization: KakaoAK {REST_API_KEY}
Content-Type: multipart/form-data

curl -v -X POST "https://dapi.kakao.com/v2/vision/text/ocr" \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: KakaoAK {REST_API_KEY}" \
    -F "image=@sample.jpg" 

import sys
import argparse
import requests
from PIL import Image, ImageFilter

API_URL = 'https://dapi.kakao.com/v2/vision/face/detect'
MYAPP_KEY = 'YOUR_APP_KEY'

def detect_face(filename):
    headers = {'Authorization': 'KakaoAK {}'.format(MYAPP_KEY)}

    try:
        files = { 'image' : open(filename, 'rb')}
        resp = requests.post(API_URL, headers=headers, files=files)
        resp.raise_for_status()
        return resp.json()
    except Exception as e:
        print(str(e))
        sys.exit(0)

def mosaic(filename, detection_result):
    image = Image.open(filename)

    for face in detection_result['result']['faces']:
        x = int(face['x']*image.width)
        w = int(face['w']*image.width)
        y = int(face['y']*image.height)
        h = int(face['h']*image.height)
        box = image.crop((x,y,x+w, y+h))
        box = box.resize((20,20), Image.NEAREST).resize((w,h), Image.NEAREST)
        image.paste(box, (x,y,x+w, y+h))

    return image



if __name__ == "__main__":
    parser = argparse.ArgumentParser(description='Mosaic faces.')
    parser.add_argument('image_file', type=str, nargs='?', default="./images/05.jpg",
                        help='image file to hide faces')

    args = parser.parse_args()

    detection_result = detect_face(args.image_file)
    image = mosaic(args.image_file, detection_result)
    image.show()

import sys
import argparse
import requests
from PIL import Image, ImageDraw, ImageFont
from io import BytesIO

API_URL = 'https://dapi.kakao.com/v2/vision/product/detect'
MYAPP_KEY = 'YOUR_APP_KEY'

def detect_product(image_url):
    headers = {'Authorization': 'KakaoAK {}'.format(MYAPP_KEY)}

    try:
        data = { 'image_url' : image_url}
        resp = requests.post(API_URL, headers=headers, data=data)
        resp.raise_for_status()
        return resp.json()
    except Exception as e:
        print(str(e))
        sys.exit(0)

def show_products(image_url, detection_result):
    try:
        image_resp = requests.get(image_url)
        image_resp.raise_for_status()
        file_jpgdata = BytesIO(image_resp.content)
        image = Image.open(file_jpgdata)
    except Exception as e:
        print(str(e))
        sys.exit(0)


    draw = ImageDraw.Draw(image)
    for obj in detection_result['result']['objects']:
        x1 = int(obj['x1']*image.width)
        y1 = int(obj['y1']*image.height)
        x2 = int(obj['x2']*image.width)
        y2 = int(obj['y2']*image.height)
        draw.rectangle([(x1,y1), (x2, y2)], fill=None, outline=(255,0,0,255))
        draw.text((x1+5,y1+5), obj['class'], (255,0,0))
    del draw

    return image

if __name__ == "__main__":
    parser = argparse.ArgumentParser(description='Detect Products.')
    parser.add_argument('image_url', type=str, nargs='?',
        default="http://t1.daumcdn.net/alvolo/_vision/openapi/r2/images/06.jpg",
        help='image url to show product\'s rect')

    args = parser.parse_args()

    detection_result = detect_product(args.image_url)
    image = show_products(args.image_url, detection_result)
    image.show()

import sys
import argparse
import requests
from PIL import Image, ImageDraw, ImageFont
from io import BytesIO

API_URL = 'https://dapi.kakao.com/v2/vision/adult/detect'
MYAPP_KEY = 'YOUR_APP_KEY'

def detect_adult(image_url):
    headers = {'Authorization': 'KakaoAK {}'.format(MYAPP_KEY)}

    try:
        data = { 'image_url' : image_url}
        resp = requests.post(API_URL, headers=headers, data=data)
        resp.raise_for_status()
        result = resp.json()['result']
        if result['adult'] > result['normal'] and result['adult'] > result['soft']:
            print("성인 이미지일 확률이 {}% 입니다.".format(float(result['adult'])*100)
        elif result['soft'] > result['normal'] and result['soft'] > result['adult']:
            print("노출이 포함된 이미지일 확률이 {}% 입니다.".format(float(result['soft'])*100)
        else :
            print("일반적인 이미지일 확률이 {}% 입니다.".format(float(result['normal'])*100

    except Exception as e:
        print(str(e))
        sys.exit(0)

if __name__ == "__main__":
    parser = argparse.ArgumentParser(description='Classify adult image.')
    parser.add_argument('image_url', type=str, nargs='?',
        default="http://t1.daumcdn.net/alvolo/_vision/openapi/r2/images/10.jpg",
        help='image url to classify')

    args = parser.parse_args()

    detect_adult(args.image_url)

import sys
import argparse
import requests
from PIL import Image, ImageFilter

API_URL = 'https://dapi.kakao.com/v2/vision/thumbnail/detect'
MYAPP_KEY = 'YOUR_APP_KEY'

def detect_thumbnail(filename, width, height):
    headers = {'Authorization': 'KakaoAK {}'.format(MYAPP_KEY)}

    try:
        files = { 'image' : open(filename, 'rb')}
        params = {'width': width, 'height': height}
        resp = requests.post(API_URL, headers=headers, data=params, files=files)
        resp.raise_for_status()
        return resp.json()
    except Exception as e:
        print(str(e))
        sys.exit(0)

def show_thumbnail(filename, detection_result, width, height):
    image = Image.open(filename)
    rect = detection_result['result']['thumbnail']
    thumbnail = image.crop((rect['x'], rect['y'], rect['x'] + rect['width'], rect['y'] + rect['height']))
    thumbnail = thumbnail.resize((width, height))

    return thumbnail


if __name__ == "__main__":
    parser = argparse.ArgumentParser(description='Make a thumbnail.')
    parser.add_argument('image_file', type=str, nargs='?', default="./images/07.jpg",
                        help='image file to make a thumbnail')
    parser.add_argument('width', type=int, nargs='?', default=150,
                        help='thumbnail width')
    parser.add_argument('height', type=int, nargs='?', default=200,
                        help='thumbnail height')

    args = parser.parse_args()

    detection_result = detect_thumbnail(args.image_file, args.width, args.height)
    image = show_thumbnail(args.image_file, detection_result, args.width, args.height)
    image.show()

import sys
import argparse
import requests
from PIL import Image, ImageDraw, ImageFont
from io import BytesIO

API_URL = 'https://dapi.kakao.com/v2/vision/multitag/generate'
MYAPP_KEY = 'YOUR_APP_KEY'

def generate_tag(image_url):
    headers = {'Authorization': 'KakaoAK {}'.format(MYAPP_KEY)}

    try:
        data = { 'image_url' : image_url}
        resp = requests.post(API_URL, headers=headers, data=data)
        resp.raise_for_status()
        result = resp.json()['result']
        if len(result['label_kr']) > 0:
            if type(result['label_kr'][0]) != str:
                result['label_kr'] = map(lambda x: str(x.encode("utf-8")), result['label_kr'])
            print("이미지를 대표하는 태그는 \"{}\"입니다.".format(','.join(result['label_kr'])))
        else:
            print("이미지로부터 태그를 생성하지 못했습니다.")

    except Exception as e:
        print(str(e))
        sys.exit(0)

if __name__ == "__main__":
    parser = argparse.ArgumentParser(description='Classify Tags')
    parser.add_argument('image_url', type=str, nargs='?',
        default="http://t1.daumcdn.net/alvolo/_vision/openapi/r2/images/08.jpg",
        help='image url to classify')

    args = parser.parse_args()

    generate_tag(args.image_url)

import json

import cv2
import requests
import sys

LIMIT_PX = 1024
LIMIT_BYTE = 1024*1024  # 1MB
LIMIT_BOX = 40


def kakao_ocr_resize(image_path: str):
    """
    ocr detect/recognize api helper
    ocr api의 제약사항이 넘어서는 이미지는 요청 이전에 전처리가 필요.

    pixel 제약사항 초과: resize
    용량 제약사항 초과  : 다른 포맷으로 압축, 이미지 분할 등의 처리 필요. (예제에서 제공하지 않음)

    :param image_path: 이미지파일 경로
    :return:
    """
    image = cv2.imread(image_path)
    height, width, _ = image.shape

    if LIMIT_PX < height or LIMIT_PX < width:
        ratio = float(LIMIT_PX) / max(height, width)
        image = cv2.resize(image, None, fx=ratio, fy=ratio)
        height, width, _ = height, width, _ = image.shape

        # api 사용전에 이미지가 resize된 경우, recognize시 resize된 결과를 사용해야함.
        image_path = "{}_resized.jpg".format(image_path)
        cv2.imwrite(image_path, image)

        return image_path
    return None


def kakao_ocr(image_path: str, appkey: str):
    """
    OCR api request example
    :param image_path: 이미지파일 경로
    :param appkey: 카카오 앱 REST API 키
    """
    API_URL = 'https://dapi.kakao.com/v2/vision/text/ocr'

    headers = {'Authorization': 'KakaoAK {}'.format(appkey)}

    image = cv2.imread(image_path)
    jpeg_image = cv2.imencode(".jpg", image)[1]
    data = jpeg_image.tobytes()


    return requests.post(API_URL, headers=headers, files={"image": data})


def main():
    if len(sys.argv) != 3:
        print("Please run with args: $ python example.py /path/to/image appkey")
    image_path, appkey = sys.argv[1], sys.argv[2]

    resize_impath = kakao_ocr_resize(image_path)
    if resize_impath is not None:
        image_path = resize_impath
        print("원본 대신 리사이즈된 이미지를 사용합니다.")

    output = kakao_ocr(image_path, appkey).json()
    print("[OCR] output:\n{}\n".format(json.dumps(output, sort_keys=True, indent=2)))


if __name__ == "__main__":
    main()